Skip to main content

🧩 How widgets work

Settings ▸ Widgets, the Quoli Core Script, the three ways a widget goes on your store, what Active means, and every widget in the library.

Quoli's widgets show your reviews on your store: on product pages, your home page, the cart and every page in between. They live inside your theme, in your layout and your brand colors, and you add each one from Settings ▸ Widgets in Quoli.

Where

Settings ▸ Widgets

Widgets

20 in the library, including eight Home Carousel styles

Needs

The Quoli Core Script app embed, on in your live theme

Plans

Every widget on every plan, except the Nuggets Slider and Checkout Nuggets (Growth and up, or Starter yearly)

The widget library with its parts numbered

➀ Categories. Product page, Carousels, Trust badges, Floating, Cart and checkout, Collection and Site pages, each with how many widgets it holds.

➁ Status and search. Show only Active or Inactive widgets, or find one by name.

➂ The widgets. One card each, with the widget itself in the picture.


Start with the Quoli Core Script

The Quoli Core Script is an app embed in your theme. It loads every widget, the review form and your brand colors and fonts. With it off, shoppers see no reviews or widgets at all, even ones you've placed.

On product pages it also gives search engines the product's rating and review count, so your stars can show in search results. Its Show ratings in search results setting turns that off.

  1. Click Activate app embed: on the setup guide's first step, or on the Quoli is off in your theme banner that Settings ▸ Widgets and Home show while it's off. Your theme editor opens at App embeds with Quoli Core Script switched on.

  2. Click Save.

Or do it by hand: Open theme editor in the title bar of Settings ▸ Widgets, then App embeds, switch on Quoli Core Script and save.


Add a widget

A widget card with its parts numbered

➀ The widget. Shown with sample reviews, as your theme editor previews it.

➁ Its name and status. The same name your theme editor uses, and whether it's on your live theme.

➂ Where it goes. The page it's made for, and what it shows.

➃ Add to theme and Instructions. Add to theme opens your theme editor with the widget in place. Instructions has the same button, and the code for themes without app blocks.

Widgets go on your store in one of three ways:

Kind

Widgets

Add to theme does

App block

Most widgets

Opens the right template with the block added. Drag it into place and click Save.

App embed

Opens App embeds with the widget switched on. Click Save, and it shows across your store.

Code or checkout

Collection Ratings, Checkout Nuggets

Collection Ratings is a line of code in your product card, from its Instructions. Checkout Nuggets has Add to checkout on Plus stores.

Instructions

The Instructions popup with its parts numbered

➀ Add to theme. The same button as on the card.

➁ The code. For themes without app blocks, or to place the widget yourself. Paste it into a Custom Liquid block or your theme code.

➂ Copy code. Copies it in one click.

Pasted code uses each widget's default settings. Keep the Core Script on: it loads the widget. Add widgets with code lists every snippet and where it goes.


Active, Inactive and Manual setup

Status

Means

Active

The widget is placed in your live theme.

Inactive

It isn't in your live theme yet.

Manual setup

Collection Ratings and Checkout Nuggets, which Quoli can't see from your theme. Check them on your store.

Quoli reads your live theme each time you open the page. For the Home Carousel, only the style you've placed reads Active. If the check fails, a banner says so with Check again.


Every widget

Category

Widgets

Product page

Carousels

Nuggets Slider, and the Home Carousel in eight styles: Review Cards, Spotlight, Photo Wall, Video Reel, Quote Cards, Collage, Big Quote and Classic

Trust badges

Floating

Popup Widget, Reviews Sidebar

Cart and checkout

Cart Reviews, Checkout Nuggets (Plus stores)

Collection

Collection Ratings

Site pages

Colors and fonts for every widget come from one place, Settings ▸ Brand. Each widget's own block settings handle its layout and what it shows. The widget language follows Settings ▸ General.


💡 Tip: Building a new theme before it goes live? Place your widgets there as usual. Statuses read your live theme, so they turn Active when you publish it.

Did this answer your question?