Skip to content
Capell CMS

Using Shopify Commerce

This guide is for staff who manage the Shopify connection and owners deciding when to rely on the catalogue. Every step uses the labels you see on screen.

Using Shopify Commerce (editor how-to)

Section titled “Using Shopify Commerce (editor how-to)”

How to connect your store

Section titled “How to connect your store”
  1. Go to Shopify Commerce.
  2. Enter the store’s Shop domain, click Connect, and follow the prompts to authorise your Shopify store.
  3. When it shows Connected store, the connection is live.
An administrator connects or reviews the Shopify store connection for a Capell site. An administrator connects or reviews the Shopify store connection for a Capell site.

How to sync and search products

Section titled “How to sync and search products”
  1. After connecting, let products sync. The screen shows the Last sync time.
  2. Use Sync now if you want to refresh the catalogue right away.
  3. Search the catalogue with Search cached catalog to find a product.
  4. Matching products appear below the search form on the Shopify Commerce page.
An operator checks whether the local product catalogue is connected and recently synced. An operator checks whether the local product catalogue is connected and recently synced. An editor searches synced Shopify products from inside Capell admin. An editor searches synced Shopify products from inside Capell admin.

How to re-sync

Section titled “How to re-sync”
  1. If a product looks out of date or is missing, trigger a re-sync.
  2. Wait for the Last sync time to update.
  3. Search again to confirm the product is current.

Rolling out Shopify Commerce (for owners)

Section titled “Rolling out Shopify Commerce (for owners)”

Turn on first

Section titled “Turn on first”
  • The store connection and a first sync. Connect and confirm products appear before building anything that depends on the catalogue.

Add when needed

Section titled “Add when needed”
NeedEnable
Keep the catalogue freshRegular re-syncs
Use products across the siteAdmin search once the first sync completes

Don’t enable yet

Section titled “Don’t enable yet”
  • Don’t rely on the catalogue before the first sync finishes and shows a recent Last sync.

Who does what

Section titled “Who does what”
RoleFirst useful screen
StaffShopify Commerce: search the synced catalogue
Site ownerShopify Commerce: manage the store link and sync

Troubleshooting for editors

Section titled “Troubleshooting for editors”
What you seeWhat it meansWhat to do
No matching products foundThe sync hasn’t run, or the product isn’t in ShopifyCheck the Last sync time and re-sync
A product is out of dateThe latest change hasn’t synced yetTrigger a re-sync and wait for Last sync to update
The store shows disconnectedThe connection dropped or expiredConnect the store again
Sync keeps failingThe Shopify API request is failingAsk your developer to check the store credentials