> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cevoid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify

> Connect your Shopify stores to sync products, track purchases, share profile data, and add widgets to your storefront.

<Note>
  Related articles:
  [Profile data & event sharing](/general/profiles/profile-data-event-sharing), [Products & Markets](/general/products-markets), [Galleries](/ugc/showcase/galleries), [On-site widgets](/program/on-site-widgets), [Purchases settings](/program/program-setup/purchases)
</Note>

Cevoid's Shopify integration connects your store with both the UGC module and Rewards program module. Sync your product catalog for product tags, track purchases for your rewards program, share profile data back to Shopify, and add widgets to your storefront without writing code.

The integration works with both separate Shopify stores and Shopify Markets, allowing you to localize all consumer-facing solutions through [Markets](/general/products-markets).

***

## Connect a Shopify store

There are two ways to connect a Shopify store to your Cevoid workspace.

### Install a Cevoid Shopify app

We recommend installing one of our Shopify apps to create your workspace and connect your first store.

1. Find Cevoid's [UGC app](https://apps.shopify.com/cevoid) or [Rewards program app](https://apps.shopify.com/cevoid-loyalty) on the Shopify App Store
2. Click **Install**
3. Approve the requested permissions

Once your workspace is set up, you can install the other Cevoid app on the same store, and it will automatically connect to the same workspace.

### Connect an additional store

To connect additional Shopify stores to an existing workspace:

1. Navigate to [Settings -> Products and markets](https://app.cevoid.com/settings/products-and-markets) or [Settings -> Integrations -> Shopify](https://app.cevoid.com/settings/integrations/shopify)
2. Click **Add store**
3. Enter your Shopify store domain (e.g., yourstore.myshopify.com)
4. Click **Connect store**
5. You are redirected to Shopify to authorize the connection
6. Approve the requested permissions
7. You are redirected back to Cevoid

Connected stores appear in the Stores section on the [Shopify integration page](https://app.cevoid.com/settings/integrations/shopify).

<Note>
  If you connect multiple separate Shopify stores, change the *Global product identifier* to **Barcode** or **SKU** in [Settings -> Products and markets](https://app.cevoid.com/settings/products-and-markets). This ensures products sync correctly across stores, since product IDs differ between separate Shopify stores.
</Note>

### Add markets from Shopify Markets

If your Shopify store uses Shopify Markets, you can add them as markets in Cevoid.

1. Navigate to [Settings -> Products and markets](https://app.cevoid.com/settings/products-and-markets)
2. Click **New market**
3. Select the Shopify store you want to add markets from
4. Select the Shopify Markets you want to add
5. Click **Add market(s)**
6. Adjust each market's settings if needed

For more details on market configuration, see [Products & Markets](/general/products-markets).

***

## UGC module

Install the [Cevoid UGC app](https://apps.shopify.com/cevoid) to add UGC widgets to your Shopify store. Learn more about [UGC with Cevoid](/ugc/introduction).

### Product catalog sync

Your product catalog syncs automatically from your connected Shopify stores. Products are available immediately for tagging UGC posts and displaying product information in widgets.

You only need to tag a product once, regardless of how many markets you have connected. The product tag automatically displays the correct price, currency, and link for each market.

### Add UGC widgets to your Shopify store

The easiest way to add UGC widgets to your Shopify store is with Cevoid's prebuilt theme sections. No code required.

1. Navigate to [UGC -> On-site widgets](https://app.cevoid.com/ugc/on-site-widgets) and select your gallery
2. Click **Embed gallery**
3. Copy the Gallery ID
4. In Shopify, open your theme editor
5. Navigate to the page where you want the gallery
6. Click **Add section** and search for "Cevoid gallery"
7. Paste the Gallery ID
8. Click **Save**

For product page galleries, use the "Product page gallery" section. For collection page galleries, use the "Collection page gallery" section. These ensure content updates dynamically for each product or collection.

You can also add galleries using custom Liquid or HTML sections. For detailed instructions on all embedding options, see [Galleries](/ugc/showcase/galleries).

### Conversion tracking for UGC analytics

Enable conversion tracking to see additional metrics like conversion rate on your UGC posts.

1. Navigate to [Analytics](https://app.cevoid.com/analytics)
2. Click **Implementation instructions**
3. Click **Enable** for each Shopify store you want to track
4. Copy the cookie information and add it to your cookie policy
5. Select your reporting currency
6. Click **Enable**

<Note>
  Cevoid's UGC analytics don't use cookies except when conversion tracking is enabled.
</Note>

### Group non-variant products

Most brands add variants directly to products in Shopify (e.g., a t-shirt with size and color options). These variants automatically share UGC across the product page gallery.

Some brands set up separate products in Shopify for each variant instead (e.g., the black t-shirt and white t-shirt are separate products). For these setups, you can group the products so they share UGC content.

1. In Shopify, navigate to the product
2. Add a tag prefixed with `cevoid:` followed by a unique identifier (e.g., `cevoid:running-shorts`)
3. Add the same tag to all other products you want to group together

Products with the same `cevoid:` tag will share images and videos in the product page gallery. Products can have multiple `cevoid:` tags if needed.

***

## Rewards program module

Install the [Cevoid Rewards program app](https://apps.shopify.com/cevoid-loyalty) to track purchases and add program widgets to your Shopify store. Learn more about [Rewards programs with Cevoid](/program/introduction).

### Purchase tracking

Cevoid automatically tracks orders from your connected Shopify stores. Tracked orders can be used to reward purchases with points and progress members through tier milestones.

Configure which orders to track, what parts of an order count, and when orders are processed in [Purchases settings](/program/program-setup/purchases).

### Discount code rewards

Discount code rewards are configured in Cevoid and match Shopify's discount code settings. When a member redeems a discount code reward, Cevoid automatically creates the discount code in your Shopify store.

The discount amount displays in the correct currency for each market. This works with both Shopify Markets and separate Shopify stores.

### Add rewards program widgets to your Shopify store

Cevoid's Shopify app for Rewards programs lets you add program widgets to your store using prebuilt theme sections.

1. In Shopify, open your theme editor
2. Navigate to the page where you want the widget
3. Click **Add section**
4. Select the **Apps** tab
5. Search for "Cevoid" and select the widget you want to add

The design, copy, and layout of each widget is configured in Cevoid. See [On-site widgets](/program/on-site-widgets) for details on available widgets and customization options.

All rewards program widgets work with both Shopify legacy customer accounts and new customer accounts. However, only selected widgets are available for customer account pages when using new accounts.

### Shopify customer accounts for authentication

When you connect a Shopify store, Cevoid automatically uses Shopify customer accounts for authentication. Members log in to your rewards program widgets using their existing Shopify store account, providing a native experience where members use the same login they use for the rest of your store.

Shopify customer accounts work with both legacy customer accounts and new customer accounts.

| Area             | Legacy accounts                      | New accounts                        |
| ---------------- | ------------------------------------ | ----------------------------------- |
| Login method     | Email and password                   | One-time code sent to email         |
| Account creation | Customers actively create an account | Customers access profile with email |

For other authentication options, see [Member access and login](/program/program-setup/member-access-login).

### Opt-in rules and Shopify account types

Your opt-in rules determine when customers become members of your rewards program. Some opt-in rules are only available with legacy customer accounts.

| Opt-in rule                      | Legacy accounts | New accounts  |
| -------------------------------- | --------------- | ------------- |
| Store account and program action | ✓               | Not available |
| Store account                    | ✓               | Not available |
| All customers                    | ✓               | ✓             |
| Widget opt-in                    | ✓               | ✓             |
| Invite only                      | ✓               | ✓             |

For details on each opt-in rule, see [Member opt-in and enrollment](/program/program-setup/member-opt-in-enrollment).

***

## Widget localization

All Cevoid widgets automatically display in the correct language, currency, and prices based on the market.

For Shopify stores using market-specific URLs, widgets detect the market from the URL. For stores without market-specific URLs, Cevoid's Shopify sections detect the correct market automatically.

Purchase incentives show the correct points-per-currency rate, and discount code rewards display amounts in the local currency. This works with both Shopify Markets and separate Shopify stores.

<Note>
  You need markets configured in Cevoid for localization to work. See [Products & Markets](/general/products-markets) for setup instructions.
</Note>

***

## Configure profile data sharing

Share profile data from Cevoid to your Shopify customers. This allows you to personalize your storefront or build customer segments in Shopify based on program membership, tier status, points balance, and more.

Profile data is configured globally and syncs to all connected Shopify stores.

<Note>
  Profiles will only be synced with a customer that exists in your store. If the profile's email is not associated with a customer, it will not be synced.
</Note>

### Share data as metafields

Metafields store profile data as structured customer metafields in Shopify.

1. Navigate to [Settings -> Integrations -> Shopify](https://app.cevoid.com/settings/integrations/shopify)
2. Click **Edit fields** in the Metafields row
3. Toggle on the fields you want to sync to Shopify
4. Click **Save**

### Share data as tags

Tags add profile data as customer tags in Shopify. Each enabled field creates a tag on the customer.

1. Navigate to [Settings -> Integrations -> Shopify](https://app.cevoid.com/settings/integrations/shopify)
2. Click **Edit tags** in the Tags row
3. Toggle on the tags you want to sync to Shopify
4. Click **Save**

For a complete list of available profile data fields, see [Profile data & event sharing](/general/profiles/profile-data-event-sharing).

***

## Sync existing profiles to Shopify

When you first enable profile data sharing or add new fields, existing profiles in Cevoid are not automatically synced. Use the manual sync to push existing profile data to Shopify.

1. Navigate to [Settings -> Integrations -> Shopify](https://app.cevoid.com/settings/integrations/shopify)
2. Click **Sync profiles**
3. Select the Shopify store to sync with
4. Optional: Toggle on *Sync specific segments* to limit the sync to specific profile segments
5. Click **Sync profiles**

Only profiles linked to existing Shopify customers will be synced.

***

## How profiles are synced with multiple Shopify stores

When you have multiple Shopify stores connected to your workspace, Cevoid routes profiles based on their market.

**One Shopify store connected:** Profiles sync to that store regardless of which market they belong to.

**Multiple Shopify stores connected:** Profiles only sync to the Shopify store linked to their market. This ensures customer data stays with the appropriate regional store.

In both cases, profiles only sync if their email matches an existing Shopify customer.

Learn more about how profiles are mapped to markets in [Profile data & event sharing](/general/profiles/profile-data-event-sharing#multiple-crm-accounts-or-stores).