Connect your Shopify store to Clione
Plans: Starter ✓ · Growth ✓ · Pro ✓ · Agency ✓
You need: a Shopify account that can install apps on your store.
There are two ways to connect a Shopify store:
- Install the Clione app from the Shopify App Store. This is the recommended way. Clione opens inside your Shopify admin, Shopify handles access, and you get everything Clione does on Shopify.
- Connect with an app you create yourself in Shopify's Dev Dashboard, using its Client ID and Client Secret. Stores connected this way before the App Store listing keep working. It gives you sync, enrichment and the meta title and description, not the storefront output.
If you're connecting BigCommerce or WooCommerce instead, see Connect BigCommerce or Connect WooCommerce.
What each way gives you
| Clione app (App Store) | Your own app | |
|---|---|---|
| Sync products, collections, pages and blog posts | ✓ | ✓ |
| Enrich them in Clione | ✓ | ✓ |
| Write the meta title and meta description (Shopify's native SEO fields) when you publish | ✓ | ✓ |
JSON-LD @graph on your storefront (the Clione SEO app embed) | ✓ | |
| Visible FAQ accordion on your storefront (the Clione FAQ app embed) | ✓ | |
| Clione opens inside your Shopify admin | ✓ | |
| Pay for your plan through your Shopify bill | ✓ (new organizations) |
Install the Clione app from the Shopify App Store
1. Install it
Find Clione in the Shopify App Store and install it on your store. Shopify shows the permissions the app asks for (the ones listed in Scopes the connection needs, except read_orders, which isn't asked for at install); approve them.
2. Clione opens inside your Shopify admin
After the install you land in Clione embedded in your Shopify admin, under Apps. There's no separate Clione login to set up first. What happens next depends on whether you already use Clione:
- New to Clione. If no Clione account uses the email of your Shopify account, Clione creates an organization for you named after your store's myshopify address (for example,
my-store), makes you its owner and connects the store. Your Shopify account's email has to be verified by Shopify; if it isn't, Clione asks you to verify it in your Shopify account settings and open the app again. You have no Clione password: you sign in through Shopify. To use Clione outside Shopify too, set a password with Forgot password? on the Clione login screen. - You already use Clione, or the store belongs to another organization. If your email already has a Clione account, or the store is already connected to an organization you're not in, Clione shows Connect your Clione account: log in once with the Clione account that manages the store. You need to be an owner or an admin of the organization, and the store counts toward your plan's store limit. After that, Clione opens straight from your Shopify admin. Your organization keeps the billing it already has.
- A colleague already connected the store. If your Shopify-verified email belongs to a member of the organization that holds the store, Clione links you automatically. If your Clione account uses two-step verification, Clione asks you to log in once to link it.
3. Choose a plan and approve it in Shopify
An organization created by the install pays for Clione through Shopify: every charge appears on your Shopify bill.
- Clione asks you to choose a plan.
- Shopify shows its approval screen with the price. Nothing is charged until you approve it there.
- Your first plan comes with a 14-day free trial (Start 14-day free trial). The trial is for the first subscription only: changing plan or reinstalling doesn't start a new one.
Every later change (a plan up or down, an add-on added or removed) is approved in Shopify the same way. An upgrade applies as soon as you approve it; a cheaper plan applies at the start of your next billing period. Your plan, its status and the charges are on Clione's Billing page; invoices live in your Shopify admin. See Billing.
4. Turn on the app embeds
The JSON-LD and the FAQ accordion only show on your storefront once you switch on the Clione SEO and Clione FAQ app embeds in your theme editor. The Setup assistants card on the store's Overview checks them and links straight to the theme editor. See Schema Injector.
Then run your first sync: Sync your catalog.
Uninstall and reinstall
- Uninstalling the Clione app disconnects the store at once. If your organization pays through Shopify and this is the store its plan is billed on, Shopify cancels your plan's subscription.
- About 48 hours later, Shopify asks Clione to erase the store's data, and Clione deletes everything it holds for that store. The organization is deleted too only if that was its only store and it pays through Shopify; an organization that pays Clione directly is never deleted this way. A store you reinstalled before then is not erased.
- Reinstalling reconnects the same store. If your organization pays through Shopify and you had opened Clione from this store before uninstalling it, Shopify asks you to approve the plan again: the same plan and add-ons you had, with no new trial. If the store is reconnected another way (a colleague linked by email, or Connect your Clione account), Clione doesn't ask for that approval. An organization that pays Clione directly keeps paying that way.
More than one Shopify store
Install the Clione app on each store. Which organization the new store joins depends on the email of your Shopify account, not on being signed in to Clione elsewhere: if that email already has a Clione account, Clione shows Connect your Clione account, and logging in there with an owner or admin of your organization adds the store to it. If that email has no Clione account, the install creates a new organization for the store. Inside the Shopify admin, Add Store doesn't offer Shopify: a Shopify store is added by installing the app on it.
On a store connected through the app, Store Settings → Credentials has nothing to enter: Shopify manages Clione's access. To disconnect, uninstall the app from your Shopify admin.
Connect with your own app
Stores connected before the App Store listing use this path, and it still works. You create your own app in Shopify's Dev Dashboard and paste its Client ID and Client Secret into Clione's Add Store form. If your organization already connects a Shopify store through the Clione app, Add Store doesn't show this form for Shopify: it shows Add Shopify stores by installing the Clione app, and you add the store by installing the app on it. Clione uses them to get short-lived access tokens from Shopify and renews those tokens itself, so you never paste a new token.
This path gives you sync, enrichment and the meta title and description. The storefront JSON-LD, the FAQ accordion and the .md files come only with the Clione app (see the table above).
Step 1 — Open the Shopify Dev Dashboard and create an app
In Shopify's Dev Dashboard, create an app. You can name it anything. "Clione" makes it easy to spot later.
Shopify changes its own screens from time to time, so this page doesn't walk through its menus. You need to do four things there:
- Create the app.
- Give it the scopes listed in Scopes the connection needs.
- Install it on your store.
- Copy its Client ID and Client Secret.
Step 2 — Give the app its scopes and install it
Give the app the scopes in the table below, then install it on the store you're connecting. It has to be installed on that exact store: the Client ID and Client Secret only work on stores where the app is installed.
Step 3 — Copy the Client ID and Client Secret
Copy the Client ID and Client Secret from the app's settings in the Dev Dashboard. Keep the Secret somewhere safe until you paste it into Clione, which stores it encrypted.
Step 4 — Add the store in Clione
-
In the Clione dashboard, click + Add website in the left rail. This opens Add Store.
-
Platform: choose Shopify. The other two cards are BigCommerce and WooCommerce.
-
Details: fill in these fields, then click Next.
- Store Name: any name that helps you recognise the store in the dashboard.
- Shopify Store URL: your
your-store.myshopify.comdomain. Enter that domain even if your shop has a custom domain. The form won't accept anything else. - Currency: the default currency for prices and reports.
-
Connect: paste the Client ID and Client Secret from Step 3, then click Create & Connect.
An existing admin API access token for the store (it starts with
shpat_) also works. Open the section under Client Secret and paste the token into Admin API Access Token.
Once the store is created, click Go to your stores.
Step 5 — Check the connection
-
Store Settings → Credentials → Test connection. Clione gets a token with your Client ID and Client Secret, then asks Shopify for your shop's details. If it works, you see "Connection OK" and your shop's name. If it doesn't, you see Shopify's own error message.
-
Setup assistants, on the store's Overview. Clione runs five checks directly against your store:
- Store connection: your store responds to Clione.
- Permissions: your app has the scopes Clione checks for (see below).
- FAQ widget on your storefront: the Clione FAQ accordion shows on your storefront. This check needs the Clione Shopify app.
- Brand instructions: you've told Clione how your brand speaks.
- Order access for Attribution: on Pro and Agency, whether Clione can read your orders, with an Allow order access button if it can't. On Starter and Growth the row only says your plan doesn't include Attribution, and nothing is asked for.
Once you've fixed something, click Check again.
Next, run your first sync. See Sync your catalog.
Scopes the connection needs
| Scope | Why Clione needs it |
|---|---|
read_products | Sync products and collections. |
write_products | Write the meta title and meta description of products and collections when you publish. |
read_content | Sync pages and blog posts. |
write_content | Write the meta title and meta description of pages when you publish. Without it, Shopify refuses every page update. |
write_discounts | Create and delete discount codes when you use Promotions. |
read_orders | Optional, and not asked for at install. Clione asks for it only on Pro and Agency, from the Order access for Attribution setup assistant, to read your orders for the Attribution report; it never changes them. On Starter and Growth it isn't asked for, and on those plans and during a free trial no order is read. With your own app, you give it read_orders in the Dev Dashboard. |
Your order data. On Pro and Agency, once you've allowed order access, Clione reads your orders from the last 30 days once a day. Without that permission it reads no orders. To allow it, click Allow order access in the Order access for Attribution setup assistant on the store's Overview, or in Store Settings → Integrations → Order access: inside your Shopify admin, Shopify asks you in a window over the app; outside it, Shopify's approval page opens in a new tab. To remove it, remove the permission from the Clione app in your Shopify admin, or uninstall the app; Clione stops reading from the next nightly run. For each order it keeps only what the Attribution report needs: the order number, date, status, currency, totals, the line items and, on Shopify, the visit that led to the order (landing page, referrer, source). Never a customer's name, email, phone or address. Order data is kept for 13 months from the order date, then deleted automatically. If you move to a plan without Attribution, Clione stops reading orders, and the ones it already kept are deleted on that same 13-month schedule.
Clione doesn't need read_themes or write_themes: it never reads or edits your theme. You switch the Clione app embeds on yourself, in the theme editor.
Troubleshooting
The Clione app
"Shopify has not verified your email address yet": Clione only creates an account for an email Shopify has verified. Verify it in your Shopify account settings, then open Clione again from your Shopify admin.
"Your Clione account could not be connected to this Shopify store": the Clione account you logged in with has to be an owner or admin of the organization, the organization needs room for one more store on its plan, and the store can't already be connected to another organization. Log in with the account that manages the store, free a store slot, or report a problem if the store is held by an organization you don't recognise.
The JSON-LD or the FAQs don't show on your storefront: the app embeds are off. Turn on Clione SEO and Clione FAQ in your theme editor.
Your own app
The form says "Enter a full myshopify.com domain": Shopify Store URL has to be your your-store.myshopify.com domain, not your custom domain.
Test connection fails: the error you see comes straight from Shopify. Check that:
- the Client ID and Client Secret come from the same app and were pasted without extra spaces;
- that app is installed on this store;
- Shopify Store URL is this store's myshopify.com domain.
Correct the values in Store Settings → Credentials and click Test connection again.
Permissions shows missing scopes: the check names the scopes your app doesn't have. Add them to your app in the Dev Dashboard and install the updated app on your store, then click Check again in Setup assistants.
Page updates fail: your app doesn't have write_content. Add it the same way.
Collections and pages don't get a meta title: by default, Clione writes the meta title on products only. Turn on Push meta_title to categories, collections, and pages in Store Settings → General. The meta description is written on every entity type regardless.
Schema Status can't see your storefront: the Schema Status card in Store Settings → Schema Injector reads your live storefront the way a crawler does. If your store is password-protected, all it reaches is the password page. Remove the password, or save it in Store Settings → Credentials under Storefront password (optional), and check again. This card, like the FAQ widget check, reports on output from the Clione Shopify app.
What Clione writes to Shopify
Clione writes to your store only when you publish from the Publish tab of a product, collection or page. With either way of connecting, it writes:
- Meta description: Shopify's native SEO description, on products, collections and pages.
- Meta title: Shopify's native SEO title. Always on products. On collections and pages, only when Push meta_title to categories, collections, and pages is on.
With the Clione app, the JSON-LD and the FAQs of each published product, collection or page also reach your storefront, rendered by the Clione SEO and Clione FAQ app embeds.
Enriching never writes anything to Shopify on its own. Clione asks you to confirm before it spends enrichment credits, and nothing reaches your store until you publish. See Enrich your catalog and Verify signals.
Questions? Email help@clione.ai.