How to Connect Your Shopify Store to SEOmatic

Written By Minh

Last updated About 15 hours ago

Minimum Requirements

  • A Shopify store on a paid plan

  • Store owner or staff admin access

  • A custom app created in your Shopify admin

Step 1: Create a Custom App on Shopify

Before connecting to SEOmatic, you need to create an app on your Shopify store that will allow SEOmatic to publish content.

  1. Log in to your Shopify admin at https://www.shopify.com/admin.

  2. Go to Apps > App settings > Develop apps > Build apps in Dev Dashboard.

  3. Click "Create app", give it a name (e.g. "SEOmatic"), and click "Create".

  4. Enable the following permissions: write_content, read_content, write_products, read_products, write_publications, read_publications, write_themes, read_themes, write_metaobjects, read_metaobjects, write_metaobjects_definitions, read_metaobjects_definitions. Click "Done".

  5. Scroll down and click "Release". A confirmation modal will appear - click "Release" again. Then click "Install app" to install it on your store.

  6. Navigate to Settings and save your Client ID and Client Secret somewhere secure. These are sensitive credentials that should not be shared with others.

Step 2: Go to Connections

In your SEOmatic dashboard, go to Connections from the sidebar (or click the "Missing connection" warning in the header if you see one).

Step 3: Enter Your Store Details

Click Connect Shopify and fill in:

  • Store domain: your Shopify domain, e.g. mystore.myshopify.com

  • Client ID: the ID from Step 1

  • Client Secret: the secret from Step 1

SEOmatic will automatically validate your credentials as you type. If any permissions are missing, you'll see a warning telling you exactly which ones to add.

Click Connect.

Step 4: You're Connected

On the Connections page, you should now see your Shopify store listed with a green "active" status - that means you're connected and ready to publish.

Troubleshooting

Problem

Solution

Invalid credentials

Double-check your Client ID and Client Secret. Make sure you copied them from the correct app in your Shopify Partner Dashboard. The Client Secret starts with shpss_.

Store not found

Make sure you're entering your .myshopify.com domain, not your custom domain. For example, use mystore.myshopify.com, not mystore.com.

Missing Shopify permissions

Your app doesn't have all the required scopes. Go back to your app settings in the Shopify Partner Dashboard, add the missing permissions listed in the warning, and reinstall the app on your store.

The Shopify app is not installed on this store

You created the app but haven't installed it yet. In the Shopify Partner Dashboard, go to your app and install it on your store.

Connection keeps timing out

Your store might be temporarily slow to respond. Try again in a few minutes. If it persists, check that your store is online and accessible.

"Invalid access token" after reconnecting

Your app may have been uninstalled or its credentials may have been regenerated. Reconnect by updating your Client ID and Client Secret in the Connections page.