Setup Guide: Shopify

This guide explains how to connect your Shopify store to SearchAtlas, allowing you to create, update, and publish SEO-optimized blog content directly on your site.

How to Connect Shopify with SearchAtlas

Step 1: Get Your Admin API Access Token

1. Go to Shopify Admin

   • Visit your Shopify admin dashboard at https://your-store.myshopify.com/admin
   • Sign in with your Shopify account

2. Navigate to API Credentials

   • In the left sidebar, click Settings
   • Select Apps and sales channels
   • Click Develop apps
   • Select your existing custom app used for integrations (for example, SearchAtlas Integration)

3. Generate a New Access Token

   • Open the API credentials tab
   • Click Generate Admin API access token if you don’t already have one
   • Once generated, click Reveal token once to view your token
   • Note: The token will only be shown once, so copy it immediately

4. Copy and Store Your Access Token

   • Copy the full access token (starts with shpat_)
   • Store it securely as it will not be shown again
   • Keep this token confidential

Step 2: Get Your Shop Name (Store Identifier)

1. Find Your Shop Name

   • Your shop name is the subdomain of your store’s .myshopify.com URL
   • Example: For https://serp-theory.myshopify.com, the shop name is serp-theory

2. Verify Your Shop Name

   • You can confirm it in your browser’s address bar when logged into Shopify Admin
   • Format: [shop-name].myshopify.com

Step 3: Get the API Version

1. Find the API Version in Admin

   • Go to Settings → Apps and sales channels → Develop apps → [Your App Name] → API credentials
   • You’ll see the API version displayed under the credentials section

2. Recommended Version

   • Use the latest stable version shown in your app (for example: 2025-01)
   • You can check available versions in Shopify’s API versioning guide

Step 4: Connect to SearchAtlas

1. Enter the Following Details in SearchAtlas

   • Access Token (starts with shpat_)
   • Shop Name (e.g., serp-theory)
   • API Version (e.g., 2025-01)

2. Test the Connection

   • Click Connect
   • SearchAtlas will verify your credentials
   • On success, you will see: "Shopify connected successfully"

Required Information

• Access Token: From your Shopify Admin (starts with shpat_)
• Shop Name: Your Shopify store name (e.g., serp-theory)
• API Version: The version shown in your app credentials (e.g., 2025-01)

Important Requirements

• Custom App: You must already have a custom app created in your Shopify Admin
• API Scopes: The app must have read_content and write_content scopes enabled
• Store Access: The access token only works for the store where the app is installed
• Blog Setup: Your store must have at least one blog created (e.g., “News”)
• API Version: Use the latest stable API version available in your admin

Troubleshooting

• Connection Failed: Check if your access token is correct and not expired
• Permission Denied: Ensure your app has read_content and write_content scopes enabled
• Invalid Shop Name: Use the correct subdomain from your Shopify Admin (e.g., serp-theory)
• Blog Not Found: Go to Online Store → Blog posts → Manage blogs to confirm at least one blog exists
• API Version Error: Use a supported API version (check Shopify Release Notes)
• Token Expired: Regenerate your access token in API credentials and update it in SearchAtlas