🔧 Configuration

Loading credential fields...
Loading configuration fields...
1 Connect
2 Operation
3 Title & HTML
4 Content

Step 1: Test Connection

Please save your credentials and configuration, then test the connection to proceed.

Step 2: Choose Operation

This is the ID returned when you created the content, or found in the CMS.

Step 3: Title & HTML Content

Enter the title and HTML content for your page or article.

This will be used as the page/article title in the CMS.
The main HTML content for your page or article. You can include HTML tags.

Step 4: Content Details

Loading content form...

📚 Installation Instructions

Setup Guide: Shopify

This guide explains how to connect your Shopify store to SearchAtlas so you can create, update, and publish blog content directly on your site. This connection allows you to:

  • Create and publish SEO-optimized blog posts from SearchAtlas to your Shopify store.

How to connect Shopify with SearchAtlas

Step 1: Access the Dev Dashboard

  1. Log in to Shopify at https://your-store.myshopify.com/admin
  2. Click Settings (bottom-left sidebar)
  3. Click Apps and sales channels
  4. Click Develop apps (top-right corner)
  5. Click Build apps in Dev Dashboard
  6. You'll be redirected to the Shopify Dev Dashboard

Step 2: Create a New App

  1. In the Dev Dashboard, click Create app
  2. Enter your app details:
Field Value
App name SearchAtlas Integration
  1. Click Create

Step 3: Configure Access Scopes

  1. In your new app, go to the Configuration section
  2. In the Access section, enter the following scopes:
read_content,write_content,read_online_store_pages,write_online_store_pages
Scope Purpose
read_content Read existing blog posts and articles
write_content Create and update blog posts
read_online_store_pages Read store pages
write_online_store_pages Modify store pages

Step 4: Configure App URL

  1. In the URLs section, set:
Field Value
App URL https://shopify.dev/apps/default-app-home
  1. Select a Webhooks API Version (e.g., 2025-01)

Step 5: Release an App Version

  1. Click Release to create an app version
  2. Fill in the version details:
Field Value
Version name 1.0.0
Version message Initial release for SearchAtlas integration
  1. Click Release

Step 6: Get Your Client Credentials

  1. Go to Settings in your app
  2. Locate and copy the following credentials:
Credential Description
Client ID Your app's unique identifier
Client Secret Your app's secret key (click to reveal)

Important: Keep your Client Secret secure. Store it safely and never share it publicly.

Step 7: Install the App on Your Store

  1. In your app, go to the Installs section
  2. Click Install app
  3. Select your store
  4. Click Install

Step 8: Get Your Shop Name

Your shop name is the subdomain of your Shopify store URL:

Your Store URL Your Shop Name
https://my-awesome-store.myshopify.com my-awesome-store
https://acme-products.myshopify.com acme-products
https://serp-theory.myshopify.com serp-theory

Step 9: Connect to SearchAtlas

  1. In SearchAtlas, go to Settings → CMS Connectors
  2. Select Shopify as your connection
  3. Fill in the following fields:
Field Description Example
Domain Your public website domain mystore.com
Shop Domain Your Shopify store domain (no trailing slash) your-store.myshopify.com
Authentication method Select from dropdown Shopify Client Credentials
Shop Name Your store name without .myshopify.com your-store
Client ID From Dev Dashboard Settings a1b2c3d4-xxxx-xxxx-xxxx
Client Secret From Dev Dashboard Settings xxxxxxxxxxxxxxxx
API Version The Shopify API version 2025-01
  1. Click Connect
  2. SearchAtlas will verify your credentials
  3. Once verified, your Shopify store will be connected successfully

Required Information Summary

Information Where to Find It
Domain Your public website URL
Shop Domain Your Shopify URL (e.g., your-store.myshopify.com)
Shop Name The subdomain part of your Shopify URL
Client ID Dev Dashboard → Your App → Settings
Client Secret Dev Dashboard → Your App → Settings (click to reveal)
API Version Use latest stable version (e.g., 2025-01)

What you can do with this integration

Feature Supported
Publish blog posts from SearchAtlas to Shopify ✅
Create posts as drafts or publish immediately ✅
Update existing blog posts ✅
Set blog categories and tags ✅
Include featured images ✅
Maintain SEO optimization from SearchAtlas ✅

Important Requirements

Requirement Details
Shopify Plan Any paid Shopify plan (Basic, Shopify, Advanced, Plus)
Custom App Must create app via Dev Dashboard
Blog Enabled Your Shopify store must have the blog feature enabled
App Installed App must be installed on your store

API Scopes Reference

Scope Required Purpose
read_content Yes Read blog posts, articles, and pages
write_content Yes Create and update blog posts
read_online_store_pages Recommended Read store pages
write_online_store_pages Recommended Modify store pages

Troubleshooting

Issue Solution
Connection failed Verify Client ID and Client Secret are correct
Can't find Dev Dashboard Go to Settings → Apps → Develop apps → Build apps in Dev Dashboard
App not appearing in store Ensure you installed the app in Step 7
Permission denied Verify all required scopes are configured and app version is released
Blog posts not appearing Ensure posts are set to "Published" and blog is visible on storefront

How to Rotate Your Client Secret

If you need to generate a new Client Secret:

  1. Go to Dev Dashboard → Your App → Settings
  2. Click Rotate next to the Client Secret
  3. Copy the new Client Secret
  4. Update the secret in SearchAtlas immediately

Note: Your previous Client Secret will stop working after rotation.

Need Help?

Resource Link
Shopify Help Center help.shopify.com
Shopify Developer Docs shopify.dev
Dev Dashboard dev.shopify.com
SearchAtlas Support Contact your SearchAtlas account manager