Shopify

Rankspiral integrates directly with your Shopify store via the Admin API. Once connected, you can publish articles to your Shopify blog with a single click — and Rankspiral will automatically link to your products and collections in generated content.

What You Get

• One-click blog publishing — Articles are published directly to your Shopify blog with formatted HTML and featured images
• Product linking — Sync your product catalog and Rankspiral's AI will naturally link to relevant products and collections in generated articles
• Collection linking — Both custom and smart collections are synced for linking opportunities

Requirements

• A Shopify store (any plan)
• An app created via the Shopify Dev Dashboard
• The read_products and write_content API scopes enabled
• Your app's Client ID and Client Secret
• A Rankspiral Pro or BYOK plan

Step 1: Create an App in the Dev Dashboard

1. In your Shopify Admin, go to Settings → Apps and sales channels → Develop apps
2. Click Build apps in Dev Dashboard — this opens the Shopify Dev Dashboard
3. Click Create app
4. Give it a name (e.g. "Rankspiral") and select your store

Step 2: Configure URLs and API Scopes

1. In your app's settings, go to Configuration
2. Under URLs, set the App URL to https://rankspiral.com. This is important — if you leave it as the default placeholder, you'll get a security warning screen when the app redirects after installation.
3. Make sure "Embed app in Shopify admin" is unchecked. Rankspiral is a standalone app and does not need to be embedded.
4. Under Admin API integration, click Configure (or Edit)
5. Search for and enable these two scopes:
   • read_products — Allows Rankspiral to fetch your products and collections for AI linking
   • write_content — Allows Rankspiral to create blog posts on your store
6. Click Save

Step 3: Install the App on Your Store

1. In the Dev Dashboard, go to your app's Overview page
2. Click Install app (top-right corner)
3. Select the store you want to install it on
4. Click Install and confirm the permissions

Step 4: Get Your Client ID and Client Secret

Shopify no longer provides static Admin API access tokens. Instead, apps use a Client ID and Client Secret to authenticate.

1. In the Dev Dashboard, go to your app's Overview or Client credentials section
2. Copy the Client ID
3. Click Show next to the Client Secret and copy the Client Secret
4. Keep both values safe — you'll need them in the next step

Rankspiral uses these credentials to request short-lived access tokens automatically — you don't need to manage tokens yourself.

Step 5: Connect in Rankspiral

1. In Rankspiral, go to your project's Integrations tab
2. Find the Shopify card and enter:
   • Store URL — Your .myshopify.com URL (e.g. mystore.myshopify.com). Don't use a custom domain. You can find this in Shopify Admin → Settings → Domains.
   • Client ID — The Client ID from Step 4
   • Client Secret — The Client Secret from Step 4
3. Click Connect Shopify

Rankspiral verifies the connection by requesting an access token and calling your store's API. If successful, you'll see a green "Connected" status.

Step 6: Sync Your Products

After connecting, click the Sync Products button. Rankspiral will fetch:

• All your products (up to 250)
• All custom and smart collections

These are cached locally and used by the AI when generating articles. The AI will naturally link to relevant products and collections within your content — for example, mentioning your "Premium Running Shoes" with a link to the product page when writing about running gear.

Click Sync Products again any time you add new products or collections to your store.

Publishing Articles

When you publish an article from Rankspiral:

• Rankspiral finds (or creates) a blog on your Shopify store
• The article is published with the full HTML content, title, slug, and meta description
• The featured image is attached to the blog post
• The published URL is saved back to Rankspiral for tracking

Troubleshooting

• "Invalid Client ID or Client Secret" — Double-check both values from your app's credentials page in the Dev Dashboard. Make sure you're copying the full values without extra spaces.
• "Could not connect" — Make sure your store URL is the .myshopify.com domain, not a custom domain. Also verify the app is installed on your store.
• "Insufficient permissions" — Make sure both read_products and write_content scopes are enabled in your app's configuration, and that you've released a new version and reinstalled the app after changing scopes.
• Products not showing in articles — Click "Sync Products" to refresh the local product cache. The AI uses the synced data, so new products won't appear until you sync.
• Red "unsafe content" security warning after installation — This happens when the App URL in your Shopify app configuration is still set to the default placeholder (e.g. https://example.com). Go to your app's Configuration in the Dev Dashboard, change the App URL to https://rankspiral.com, save, and release a new version. The warning will stop appearing.