Skip to main content

​
Overview

The Shopify integration allows you to publish articles directly to your Shopify store’s blog. This guide walks you through setting up the connection step by step.

​
Setting Up the Shopify App

​
Step 1: Log in to Shopify

  1. Log in to your Shopify admin panel

​
Step 2: Enable App Development

  1. Click on Apps
  2. Click on App and sales channel settings
  3. Click on Develop apps

​
Step 3: Create App in Dev Dashboard

  1. Click on Build apps in Dev Dashboard (you will be redirected to dev.shopify.com)
  2. Click on Create app
  3. Set the app name to “Genese”
  4. Change the default app URL from https://example.com to https://app.genseo.co
  5. Disable “Embed app in Shopify admin”

​
Step 4: Configure Permissions

  1. Select the following scopes:
    • read_content
    • write_content

​
Step 5: Set Redirect URL

  1. Set the redirect URL to: https://app.genseo.co/api/integrations/shopify/callback

​
Step 6: Release the App

  1. Click on Release
  2. Confirm the release again

​
Step 7: Set Up Custom Distribution

  1. Click on Home in the left sidebar
  2. Click on Select distribution method under Distribution on the right
  3. Select Custom distribution
  4. Enter your store URL (e.g., MY-STORE-URL.myshopify.com)
  5. Click on Generate Link
  6. Copy the link and open it in a new browser
  7. Select your shop

​
Connecting Shopify in Genseo

​
Step 1: Connect Shopify in Genseo

  1. Open Genseo and navigate to the Integrations page
  2. Click Connect next to Shopify
  3. Enter your shop URL (e.g., MY-STORE-URL.myshopify.com)

​
Step 2: Copy Client ID and Secret

  1. Go back to dev.shopify.com where you created the app
  2. Select the app
  3. Click on Settings
  4. Copy the Client ID and Secret
  5. Paste both values into Genseo

​
Step 3: Save Configuration

  1. Click on Save Configuration
  2. Click on Connect or Connect

​
Blog Configuration

​
Field Mapping

After successful connection:
  1. Select your blog under Blog
  2. Map the following fields:
    • Title → Title
    • Body → Body
    • Thumbnail → Thumbnail
    • Meta Description → Excerpt (the meta description field must be connected to excerpt)
    • Excerpt → Excerpt
The keyword field is not supported by Shopify and cannot be mapped.

​
Save Configuration

  1. Click on Save Configuration
  2. The connection is now successfully set up

​
Publishing Articles

After successful setup, you can publish articles directly from Genseo to your Shopify blog:
  1. Create or open an article in Genseo
  2. Click Publish
  3. Select Shopify as the destination
  4. Confirm the publication

​
Common Issues

​
Connection Errors

Problem: Connection to Shopify fails. Solution:
  • Verify that the redirect URL is set correctly
  • Ensure the Client ID and Secret were copied correctly
  • Make sure the app was released in Shopify

​
Permission Errors

Problem: Articles cannot be published. Solution:
  • Check that the scopes read_content and write_content are enabled
  • Ensure the app is installed in your shop

​
Field Mapping Issues

Problem: Fields cannot be mapped. Solution:
  • Make sure Meta Description is connected to Excerpt
  • Note that the keyword field is not supported

​
Next Steps