# General implementation

> Run Cevoid on another ecommerce platform or a headless setup, with product feeds, Cevoid's scripts, and orders your system sends to the Cevoid API.

Breadcrumb: Integrations › General implementation · Updated: 2026-10-17
Docs index: https://docs.cevoid.com/llms.txt

The general implementation connects Cevoid to a store on another ecommerce platform, or to a headless setup, without a dedicated integration. Your catalog comes from product feeds, Cevoid's scripts load your widgets, and your own system sends your orders to the Cevoid API.

Navigate to [Settings → Products and markets](https://app.cevoid.com/settings/products-and-markets) to start with your markets and product feeds.

> [!NOTE]
> This setup needs access to your site's code, and server-side code to send your orders and to log members in with your own login. If you don't edit your site yourself, share these steps with your developer.

## What the general implementation does

| Used by | What the general implementation does for it | Read more |
| --- | --- | --- |
| UGC | Products for product tags and product galleries, and the gallery script for galleries and cards | [Galleries](https://docs.cevoid.com/ugc/showcase/galleries.md), [Cards](https://docs.cevoid.com/ugc/showcase/cards.md) |
| Loyalty program | Orders for points and tier milestones, the Cevoid script for program widgets, and member login | [Embed program widgets](https://docs.cevoid.com/loyalty/setup/embed-program-widgets.md), [Purchase incentives](https://docs.cevoid.com/loyalty/rewards/purchase-incentives.md) |
| Reviews | Orders for review requests and verified buyers, the products customers review, and the Cevoid script for review widgets and review forms | [Setup checklist](https://docs.cevoid.com/reviews/setup/setup-checklist.md), [Embed review widgets](https://docs.cevoid.com/reviews/showcase/embed-review-widgets.md) |
| Orders and products | The products and orders on the Products and Orders pages | [Products](https://docs.cevoid.com/orders-products/products.md), [Orders](https://docs.cevoid.com/orders-products/orders.md) |
| Analytics | Sales tracking with Cevoid's analytics SDK | [Report requirements](https://docs.cevoid.com/analytics/setup/report-requirements.md#set-up-sales-tracking) |

## What syncs

| Data | Direction | Used by |
| --- | --- | --- |
| Products | Your product feeds to Cevoid, about once a day, and when you click **Sync products** | UGC and Reviews |
| Orders | Your system to the Cevoid API, each time it creates, updates, or deletes an order | Reviews, Loyalty program, and post-purchase upload requests in UGC |
| Completed checkouts | Your order confirmation page to Cevoid, with Cevoid's analytics SDK | Analytics: sales tracking |
| Events | Cevoid to your own service, as webhooks that a flow sends | Your own systems |

## Product catalog

Product feeds bring your products into Cevoid: one or more XML, CSV, or TSV files at a URL for each market. The Cevoid API reads products but doesn't add or change them, so your catalog always comes from your feeds.

Each version of your storefront with its own domain, language, or currency is a market, with feeds of its own. Create the market first: until your workspace has one, [Settings → Products and markets](https://app.cevoid.com/settings/products-and-markets) shows **New market** next to _Set up your first product feed and market_. See [Create a market](https://docs.cevoid.com/localization/products-markets.md#create-a-market). Once the market exists, add its feeds, as described in [Add a product feed](https://docs.cevoid.com/integrations/ecommerce/product-feeds.md#add-a-product-feed), and start its first sync: see [Sync a new market](https://docs.cevoid.com/localization/products-markets.md#sync-a-new-market).

After its first sync, Cevoid syncs each feed about once a day, and when you click **Sync products** on the market. A change in a feed shows in Cevoid after the next sync: see [When products sync](https://docs.cevoid.com/orders-products/products.md#when-products-sync).

## Add Cevoid's scripts

Three scripts load Cevoid's widgets, one for each kind of widget. A page needs the script for each kind of widget it shows. On a headless Shopify storefront, they work the same way.

| Script | Loads | Add it to |
| --- | --- | --- |
| The Cevoid script, from `widget.cevoid.com` | Review widgets and review forms | Every page |
| The gallery script, from `gallery.cevoid.com` | Galleries and cards | Every page with a gallery or a card |
| The Cevoid script for program widgets, from `autoloader.cevoid.com` | Program widgets | Every page with a program widget |

If your site changes content without a full page reload, the Cevoid script also loads review widgets added later. Galleries and cards need a refresh: see [Runtime helpers](https://docs.cevoid.com/developers/widget/runtime-helpers.md) in the developer docs.

### Add the Cevoid script

The Cevoid script, which loads review widgets and review forms, goes on every page: review request links open the review form on the start page of the customer's market. It loads nothing until a widget comes close to the visible part of the page.

1. Navigate to [Reviews → On-site widgets](https://app.cevoid.com/reviews/on-site-widgets) and click **Script status**. The _Install the Cevoid script_ dialog opens. **Add script** in _Things to do_ on [Reviews → Overview](https://app.cevoid.com/reviews) opens it too.
2. Copy the script under _Install with code_
3. Paste the script right before the closing `</head>` tag on every page of your site
4. Publish the change to your site
5. Click **Check status** in the dialog. Each market shows _Installed_ once Cevoid finds the script.

The script carries your workspace's publishable key, which tells Cevoid which workspace the page belongs to:

```html
<script type="module" src="https://widget.cevoid.com/index.js" async data-cevoid-publishable-key="cev_pk_…"></script>
```

Each review widget's _Embed widget_ dialog, and each review form's embed dialog, show the same script under _Embed with code_. For each status, see [Check the Cevoid script](https://docs.cevoid.com/reviews/showcase/embed-review-widgets.md#check-the-cevoid-script).

### Add the gallery script

The gallery script, which loads galleries and cards, isn't the Cevoid script, so add it even when your site already has that one. The dialogs that **Embed gallery** and **Embed card** open don't show it, so copy it from here.

Paste the gallery script once on every page that shows a gallery or a card, in the `<head>` or right before the closing `</body>` tag, and publish the change. It loads a gallery or a card into each `cevoid-container` div on the page.

```html
<script type="module" src="https://gallery.cevoid.com/index.js" defer></script>
```

### Add the Cevoid script for program widgets

The Cevoid script for program widgets loads your program widgets. Every program widget's embed dialog shows it under _Embed with code_.

1. Navigate to [Loyalty → On-site widgets](https://app.cevoid.com/program/widgets) and open a widget
2. Click **Embed**. _Embed widget_ opens, or _Embed landing page_ for the Full landing page.
3. Copy the script under _1. Add Cevoid script_.
4. Paste the script right before the closing `</head>` tag on every page with a program widget
5. Publish the change to your site

```html
<script async src="https://autoloader.cevoid.com/autoloader.js" type="module"></script>
```

## Place widgets on your pages

Each widget's embed dialog shows its code, with the widget's ID filled in. Paste the code where the widget should appear, on a page that has the widget's script.

| Widget | Code | Steps |
| --- | --- | --- |
| Review widgets | A `cevoid-reviews` element | [Embed a review widget](https://docs.cevoid.com/reviews/showcase/embed-review-widgets.md#embed-a-review-widget) |
| Review forms | A link that opens the form | [Link to a review form](https://docs.cevoid.com/reviews/collect/review-forms.md#link-to-a-review-form) |
| Galleries and cards | A `cevoid-container` div | [Embed galleries on your website](https://docs.cevoid.com/ugc/showcase/galleries.md#embed-galleries-on-your-website), [Embed cards on your website](https://docs.cevoid.com/ugc/showcase/cards.md#embed-cards-on-your-website) |
| Program widgets | A `cevoid-widget` div | [Embed with code](https://docs.cevoid.com/loyalty/setup/embed-program-widgets.md#embed-with-code) |

### Product, collection, category, and brand

Dynamic widgets, such as the product page gallery, show the content of the page they're on. Their code carries `data-product`, `data-collection`, `data-category`, or `data-brand`, set to `auto` or to an explicit value. Program widgets take none.

With `auto`, Cevoid reads the page's URL: on a product page, it looks for the product whose _Link_ in your feed is that URL, or else ends in the same last part of the path. Where the URL doesn't identify the page's product, collection, category, or brand, such as on a storefront with its own routes, set an explicit value instead, such as the product's _ID_ from your feed. The values each widget accepts are in its article.

### Markets

Widgets show the language, currency, prices, and product links of the market they load in. Cevoid matches the page's URL to your markets' domains, and uses your default market when none matches: see [How localization works](https://docs.cevoid.com/localization/products-markets.md#how-localization-works).

Galleries and cards can also take their market from a `data-market` attribute with the market's _Custom ID_, for a storefront whose URLs don't tell its markets apart. For this and their other attributes, see the [UGC Widgets developer docs](https://docs.cevoid.com/developers/widget.md). Review widgets and program widgets have no market attribute.

## Log members in to program widgets

Members log in to program widgets with Cevoid's email login or with your own. Select the method in _Authentication_ in [Settings → Loyalty → General](https://app.cevoid.com/settings/loyalty/general):

- **Email authentication by Cevoid:** Members enter their email and a verification code that Cevoid sends them. It needs no code on your site, and workspaces not created from a Cevoid Shopify app start with it.
- **Custom store authentication:** Customers logged in to your site are logged in to your program widgets. Your server signs each customer's ID and email, and the widget code carries the signature: see [Custom customer authentication](https://docs.cevoid.com/integrations/ecommerce/custom-customer-authentication.md).

For both methods, see [Available authentication methods](https://docs.cevoid.com/loyalty/setup/general-program-settings.md#available-authentication-methods).

## Send orders to Cevoid

Review requests, verified buyers, points for purchases, and tier milestones all depend on your orders. On other platforms, your own system sends each order to the Cevoid API, and updates it when it's fulfilled, delivered, or refunded. Flows that start on _Order fulfilled_ or _Order delivered_, such as review requests, run on those updates.

For the API key and the request, see [Send orders through the API](https://docs.cevoid.com/orders-products/order-settings.md#send-orders-through-the-api). To check that orders arrive for each market, see [Check orders per market](https://docs.cevoid.com/orders-products/order-settings.md#check-orders-per-market).

## Track sessions and sales

Session tracking links each visitor's events into visits with a cookie, for visitors whose consent allows it. Without Shopify, your developer passes your cookie banner's choice to Cevoid through Google consent mode or Cevoid's consent flag. If neither is on the page, Cevoid sets the cookie for every visitor once session tracking is on. See [Session tracking and consent](https://docs.cevoid.com/analytics/setup/session-tracking-and-consent.md).

Sales tracking links orders to the content your visitors saw. Without Shopify's checkout web pixel, it's a sales tracking call on your order confirmation page, with Cevoid's analytics SDK: see the _General implementation_ tab of [Set up sales tracking](https://docs.cevoid.com/analytics/setup/report-requirements.md#set-up-sales-tracking).

## Send events and profile data to your systems

A flow can send events, such as a fulfilled order or a submitted review, to your own service as signed webhooks: see [Webhooks via Flows](https://docs.cevoid.com/flows/webhooks.md). Cevoid shares profile data with an ecommerce platform only on Shopify, so your systems read profiles over the Cevoid API: see [Where data and events can be shared](https://docs.cevoid.com/profiles/profile-data-event-sharing.md#where-data-and-events-can-be-shared).

## What works differently without a native integration

Some features need a native integration. On other platforms:

- **Discount codes:** Cevoid creates discount codes for rewards only in Shopify. Discount code rewards, including free shipping and free product codes, use codes you upload: see the _Manual_ tab of [Discount code: Amount or percentage off](https://docs.cevoid.com/loyalty/rewards/available-rewards.md#discount-code-amount-or-percentage-off).
- **Store account login:** The authentication method **Store account authentication by Shopify** needs Shopify, and so do the opt-in rules **Store account** and **Store account and program action**. See [How opt-in rules work](https://docs.cevoid.com/loyalty/setup/general-program-settings.md#how-opt-in-rules-work).
- **Marketing consent:** Orders sent through the API carry no marketing consent. Review requests that Cevoid emails go only to customers who agreed to marketing email, and requests sent through Klaviyo, Voyado, or a webhook aren't checked: see [Who gets a review request](https://docs.cevoid.com/reviews/collect/review-requests.md#who-gets-a-review-request).
- **Rich snippets:** Review widgets add the rating's structured data in the shopper's browser, where the **Product rating** block on Shopify puts it in the page's HTML. See [Rich snippets on other platforms](https://docs.cevoid.com/reviews/showcase/google-rich-snippets.md#rich-snippets-on-other-platforms).

## Related articles

- [Product feeds](https://docs.cevoid.com/integrations/ecommerce/product-feeds.md)
- [Order settings](https://docs.cevoid.com/orders-products/order-settings.md)
- [Embed review widgets](https://docs.cevoid.com/reviews/showcase/embed-review-widgets.md)
- [Galleries](https://docs.cevoid.com/ugc/showcase/galleries.md)
- [Embed program widgets](https://docs.cevoid.com/loyalty/setup/embed-program-widgets.md)

---

Canonical: https://docs.cevoid.com/integrations/ecommerce/general-implementation