Skip to main content

Using Judge.me Reviews with Shopify Canvas

How to turn on Judge.me in a Shopify Canvas theme and add the review widgets, by yourself or with Sidekick.

Available on the Free plan

Shopify Canvas is Shopify's new way to design your store by chatting with Sidekick. Canvas is in early access, so only some stores have it.

Canvas can't add apps itself, so the usual Judge.me setup steps don't work there. This article shows you two ways to set up Judge.me: do it yourself in the code, or ask Sidekick to do it for you.


How it works

  • Canvas can't add or configure app blocks or app embeds on its own. Shopify says this on its Canvas requirements page. It's a Shopify limit, so it affects other apps too.

  • Judge.me needs its app embed. You normally turn it on from the App embeds menu in the theme editor. Canvas doesn't have that menu. See Adding the Review Widget on your product page.

  • You can still do both steps another way. You can edit your theme's code yourself, or ask Sidekick to edit it.

  • Canvas can't show Judge.me in its own preview. You check your widgets on the storefront preview instead.

  • A theme you edit in Canvas has a Canvas label. You see it next to the theme name in Online Store > Themes.


Considerations

  • Don't add the Judge.me Core code by hand. It doesn't work with the newer versions of the widgets. Turn on the app embed instead.

  • Themes made by Canvas use Liquid templates. App blocks can't be placed in them. You add the widgets with Judge.me's Liquid code instead.

  • Themes you duplicated from a regular theme, like Dawn, use JSON templates. They can hold Judge.me app blocks.

  • Duplicating a theme keeps its app embeds. A copy of a theme that has the Judge.me embed already has it.

  • Vintage themes also use Liquid code instead of app blocks. The Adding Judge.me widgets in Vintage themes article has the same Liquid steps. Its Step 1 uses the App embeds menu, which Canvas doesn't have. Use Step 1 in this article instead.

  • Sidekick can only place Judge.me app blocks your theme already has. It can't create a new Judge.me block type from nothing.

  • For widgets your theme has no block for, Sidekick uses Judge.me's Liquid code. On a theme with JSON templates, it puts the code in its own Custom Liquid section.

  • Judge.me app block names are not always the widget names. For example, a Trust Badge block is not the Verified Reviews Counter. Use the widget names from this article when you ask Sidekick.

  • Canvas only works with Shopify's themes and custom themes. Shopify doesn't support third-party themes in Canvas.

  • You need the Edit code permission. Shopify requires it to open Canvas, and you also need it to edit your theme's code.


Step 1: Turn on the Judge.me app embed

Pick one of these two options.

Option A: Ask Sidekick

  1. In Canvas, open the chat with Sidekick.

  2. Type: Please turn on the Judge.me app embed.
    ​

  3. Sidekick tells you it turned the embed on.

  • If your theme never had the embed, Sidekick copies it from another theme in your store that has it.

  • If no theme in your store has the embed, use Option B below.

Option B: Do it yourself in the code

  1. From your Shopify admin, go to Online Store > Themes.

  2. Find your theme, click the 3-dot icon (...), and select Edit code.

  3. Under Config, open the settings_data.json file. Or, search for it
    ​

  4. Look for a block whose type contains judgeme_core.
    ​

If you find it: change "disabled": true to "disabled": false.

If you don't find it: add the block yourself.

  1. Find the line of the last setting inside "current". Add a comma at the end of it.

  2. On a new line, paste this:

"blocks": {
  "judgeme_core_1": {
    "type": "shopify://apps/judge-me-reviews/blocks/judgeme_core/61ccd3b1-a9f2-4160-9fe9-4fec8413e5d8",
    "disabled": false,
    "settings": {}
  }
}
  1. If the file already has a "blocks" section, add only the "judgeme_core_1": { ... } part inside it.

  2. Click Save.


Step 2: Add the Judge.me widgets

Pick one of these two options.

Option A: Ask Sidekick

  1. In Canvas, open the chat with Sidekick.

  2. Type this, and delete the widgets you don't want:
    ​
    "Please add the Judge.me widgets to this theme. On the product page: the Star Rating Badge under the product title and the Review Widget below the main product section. On the home page: the Reviews Carousel, Judge.me Medals, UGC Media Grid, Verified Reviews Counter and All Reviews Counter. If a widget is already there, don't add it twice. If you can't add one, tell me exactly what stopped you."
    ​

  3. Sidekick adds the widgets and tells you what it did for each one.

  4. Check each widget on the storefront. See Step 3.

What Sidekick does depends on your theme:

  • A theme made by Canvas: it can't use app blocks. It uses Judge.me's Liquid code for each widget and skips any that are already in your theme.

  • A duplicate of a regular theme, like Dawn: it skips widgets your theme already has as app blocks. It can't add a new app block type, so it adds the other widgets with Judge.me's Liquid code in their own Custom Liquid sections.

Things to know:

  • Sidekick may say a widget is already there when it's a different one. It may skip the Verified Reviews Counter because your theme has a Trust Badge block. They are different widgets. Ask again: "Please add the Verified Reviews Counter using Judge.me's Liquid code."

  • Sidekick may change the code a little to fit your theme. For example, it can make the carousel heading editable text or match your theme's heading style. The widget still works.

  • The UGC Media Grid needs your Instagram account. Sidekick can add it, but it stays empty until you connect Instagram and publish a post.

Option B: Do it yourself in the code

  1. From your Shopify admin, go to Online Store > Themes.

  2. Find your theme, click the 3-dot icon (...), and select Edit code.

  3. Open Liquid code for Judge.me widgets and copy the code for the widget you want.

  4. Paste it in the right place in your theme. See the list below.

  5. Click Save.

Where each widget goes:

  • Star Rating Badge: on the product page, under the product title.

  • Review Widget: on the product page, below the main product section.

  • Reviews Carousel, Judge.me Medals, UGC Media Grid, Verified Reviews Counter, All Reviews Counter: on the page you want them on, for example the home page. Each one has its own code in the article above.

On a theme made by Canvas, product page code goes in templates/product.liquid.

On a theme with JSON templates, like a Dawn copy, the code needs a section to live in. The easiest way is to use Option A and ask Sidekick to add it in a Custom Liquid section.


Step 3: Check your widgets

  1. From your Shopify admin, go to Online Store > Themes.

  2. Find your theme, click the 3-dot icon (...), and select Preview.

  3. Open a product that has published reviews. Check that the star rating and the Review Widget show.

  4. Open the page where you added the other widgets, like the home page. Check that each one shows.

What you should see:

  • Star Rating Badge: the stars and review count under the product title.

  • Review Widget: the reviews list with a Write a review button.

  • Reviews Carousel: review cards that slide.

  • Judge.me Medals: your medal badges.

  • UGC Media Grid: a grid of your Instagram photos and videos.

  • Verified Reviews Counter: your number of verified reviews.

  • All Reviews Counter: a line like "Customers rate us 4.8/5 based on 221 reviews."

Some widgets stay empty when they have nothing to show:

  • Star Rating Badge: if a product has no reviews, the star rating doesn't show.

  • Review Widget: on a product with no reviews, it shows an empty reviews area with a Write a review button. If your Review collection setting is No one, the widget stays hidden on that product.

  • UGC Media Grid: if you haven't connected Instagram and published a post, the area stays empty.


Troubleshoot


I can't find the App embeds menu in Canvas.

Why it happens:

Canvas doesn't have an App embeds menu. Shopify says you can't add or configure app embeds in Canvas.

How to fix:

Turn the app embed on with Sidekick or in settings_data.json. See Step 1.


I don't see Judge.me in the Canvas preview.

Why it happens:

Canvas can't preview app blocks or apps, like the Judge.me star rating.

How to fix:

Use Preview from Online Store > Themes instead. See Step 3.


I can't find the Judge.me block in settings_data.json.

Why it happens:

The theme never had the Judge.me app embed turned on, so the block isn't in the file.

How to fix:

Ask Sidekick to turn it on, or add the block yourself. See Step 1.


The widget code is on the page, but nothing shows.

Why it happens:

The code needs the Judge.me app embed to load. Without the embed, the widget stays empty.

How to fix:

Turn the app embed on. See Step 1.


Sidekick says it can't add the Judge.me block.

Why it happens:

Sidekick can only place Judge.me app blocks that are already in your theme. Canvas can't add new app blocks yet. Themes made by Canvas also have no place for app blocks.

How to fix:

Use the Liquid code. See Step 2, Option B.


Sidekick says a widget is already there, but I don't see it.

Why it happens: Sidekick may match a widget to a block with a similar name. For example, a Trust Badge block is a different widget from the Verified Reviews Counter.

How to fix: Ask for the widget by its exact name and say to use Judge.me's Liquid code. For example: "Please add the Verified Reviews Counter using Judge.me's Liquid code."


The UGC Media Grid is empty.

Why it happens: The UGC Media Grid shows your Instagram posts. It stays empty until you connect Instagram and publish at least 1 post. It is also hidden when your Instagram connection expires, which happens every 2 months.

How to fix: Connect your Instagram account and publish a post. See UGC Instagram Shopping Widget. If the other widgets show, the code and app embed are working.


Resources

  1. See our latest updates:
    ➡️ Check our Unboxed page to discover newly launched features and improvements from Judge.me. See what's new and start using the latest updates to grow your store.

Did this answer your question?