Skip to main content

🏅 Rating Badge

Your store's rating in a small card for your header, footer or product page: what it shows, what a click does, every block setting and the code.

The Rating Badge shows your store's overall rating in a small card: the stars, your average out of 5 and how many reviews it's based on. Put it in your header, your footer or beside the buy button, so shoppers see the proof on every page.

Shows on: Any page: header, footer, home page or product page

Add it from: Settings ▸ Widgets ▸ Rating Badge ▸ Add to theme

Needs: The Quoli Core Script app embed

Plans: Every plan

The Rating Badge with its parts numbered

➀ Your store's rating. The stars, your average out of 5 and the review count, from every published review: product reviews and store reviews.

➁ Verified. The word Verified and the Quoli mark, which opens How reviews work (below). Show it or hide it, on every plan.


Add it to your theme

  1. In Quoli, open Settings ▸ Widgets and find Rating Badge.

  2. Click Add to theme. Your theme editor opens with the badge added as a new section.

  3. Drag it where you want it and click Save. It also fits in your header or footer: add it there from the theme editor's Add section menu.

The badge stays hidden until your store has its first published review, so it never shows "0 reviews".


What a click does

By default a click opens the Reviews Sidebar on all your reviews, with the same rating and count as the badge.

Clicking the Rating Badge opens the Reviews Sidebar on all 613 reviews, then closing it

Change it under On click in the block.

  • Open reviews sidebar (default). The Reviews Sidebar slides in on all your reviews. It works even if you haven't added the sidebar to your theme.

  • Go to reviews page. Opens the page you enter under Reviews page, usually your All Reviews Page.

  • Not clickable. The badge just shows your rating.


How reviews work

Hover over or tap Verified and a short panel tells shoppers how your reviews work: customers write them, most are requested by email after a purchase, Verified buyer means the review is matched to a real order, and the rating is the average of every published review. It closes when they move away, tap outside it or press Esc. A click anywhere else on the badge still does what On click says.

The Rating Badge with How reviews work open under it


Make it yours

Add a line above the stars with Lead text. Here with Loved by customers:

The Rating Badge with Loved by customers above the stars

Turn off the average, the stars or the count to keep it even smaller. Colors and fonts come from Settings ▸ Brand in Quoli.


Block settings

Content

  • Lead text. An optional line above the stars, like Loved by customers. Default: Blank.

  • Show average rating. The average out of 5. Default: On.

  • Show stars. The stars. Default: On.

  • Show review count. Based on N reviews. Default: On.

  • Alignment. Left, center or right in its section. Default: Center.

Link

  • On click. Open reviews sidebar, go to reviews page, or not clickable. Default: Open reviews sidebar.

  • Reviews page. The page a click opens, when On click is Go to reviews page. Default: Blank.

Branding

  • Verified by Quoli. Show or hide Verified and the Quoli mark. A badge saved with the old "logo only" choice shows it too. Default: Show.

Spacing

  • Top padding, Bottom padding. Space above and below the badge, 0 to 40 px. Default: 20 px each.


Add it with code

On a theme without app blocks, paste the badge in yourself. The code is in Settings ▸ Widgets ▸ Rating Badge ▸ Instructions, with a Copy code button.

<quoli-reputation-badge
  merchant-id="{{ shop.permanent_domain }}"
  api-base="/apps/quoli"
></quoli-reputation-badge>

Paste it anywhere in your theme, like your header or footer, and keep the Quoli Core Script app embed on. Pasted code uses the default settings above.


💡 Tip: For a full-width strip on your home page or footer instead of a card, use the Trust Bar. It shows the same rating in one line.

Did this answer your question?