Shopify

Shopify Integration

Publish your AI-generated content directly to Shopify as blog articles, static pages, or both. Connect your Shopify store and push content with one click.

---

What You Can Do

• One-click publish articles to your Shopify blog

• Create static pages for landing pages and evergreen content

• Publish as draft or live: you control the default

• Featured images are included automatically

• Auto-publish articles as soon as they're generated

• Bulk export entire projects to Shopify at once

• Choose content type: blog article, page, or both simultaneously

---

Prerequisites

Before connecting, you'll need:

1. A Shopify store with admin access

2. A Custom App with Admin API access token (see setup below)

3. A Cuppa account on Power plan or higher

---

Step 1: Create a Custom App in Shopify

1. Log in to your Shopify Admin

2. Go to Settings > Apps and sales channels

3. Click Develop apps (you may need to enable custom app development first)

4. Click Create an app

5. Name it something like "Cuppa Publishing"

6. Under Configuration, click Configure Admin API scopes

7. Enable these scopes:

   • write_content (for blog articles and pages)

   • read_content

8. Click Save

9. Click Install app

10. Copy the Admin API access token

Important: The access token is only shown once. Copy and save it immediately.

---

Step 2: Connect in Cuppa

1. Go to Team Settings > Integrations

2. Find Shopify and click Connect

3. Enter your:

   • Store URL: Your mystore.myshopify.com domain

   • Admin API Access Token: From Step 1

4. Click Test Connection to verify

5. Configure your defaults (see Step 3)

6. Click Save

---

Step 3: Configure Defaults

After connecting, set your preferences:

Content Type

Option	What It Does
Article	Creates blog articles (requires selecting a blog)
Page	Creates static pages
Both	Creates both an article and a page from the same Cuppa content

Blog Selection

If publishing as articles, select which Shopify blog to publish to. Cuppa loads your available blogs automatically.

Publish Status

• Draft: Content saved as draft in Shopify (recommended to start)

• Published: Content goes live immediately

Auto-Publishing

• ON: Articles auto-publish to Shopify when generated

• OFF: Manual publishing only

---

Publishing Content

Single Article

1. Open any article in Cuppa

2. Click Send to > Shopify

3. Content publishes with your configured defaults

From a Project

1. Open your project

2. Use the Publish options to send to Shopify

3. Choose which articles to publish

Bulk Export

1. Select multiple articles

2. Choose Export to Shopify

3. Articles are processed in the background (15 at a time with rate limiting)

4. Track progress in the bulk publishing status

---

What Gets Published

From Cuppa	To Shopify Article	To Shopify Page
Title	Article title	Page title
Content	Article body (HTML)	Page body (HTML)
Slug	URL handle	URL handle
Excerpt	Article excerpt	N/A
Featured Image	Article image	N/A
Author	Article author (if configured)	N/A

---

Rate Limiting

Shopify's GraphQL API uses cost-based throttling. Cuppa handles this automatically:

• Single publishes: instant

• Bulk exports: processed in chunks of 15 with 1.5-second delays

• Progress is tracked and visible during bulk operations

---

Troubleshooting

"Connection failed"

Check your store URL:

• Use your .myshopify.com domain (e.g., mystore.myshopify.com)

• Don't include https:// or a trailing slash

• Don't use a custom domain

Check your access token:

• Copy the complete token (it's only shown once when created)

• Make sure the custom app is installed

• Verify it hasn't been revoked

"Publishing failed"

• Verify your custom app has write_content scope

• Check that the selected blog still exists in Shopify

• Very long articles may hit Shopify's API limits

• Ensure featured images are publicly accessible URLs

Articles not appearing in Shopify

• Check Blog posts > Drafts (may be saved as draft)

• Verify the correct blog is selected in Cuppa settings

• Check Online Store > Pages if publishing as pages

Bulk export seems slow

• Shopify rate limits are handled automatically

• 15 articles per chunk with pauses between

• Large exports (100+ articles) may take several minutes

• Progress updates are shown during the export

---

FAQ

Can I publish to multiple Shopify stores? Each Cuppa team connects to one Shopify store. If you manage multiple stores, set up separate teams.

Does it update existing articles? Currently creates new content. Delete in Shopify and republish to update.

Can I use this with Shopify's blog SEO features? Content publishes as standard blog articles/pages. Shopify's built-in SEO fields (title, description) use the content you've set in Cuppa.

Does it work with Shopify themes? Articles and pages publish as standard Shopify content. Your theme controls how they're displayed.

What about product descriptions? This integration is for blog articles and pages. Product content is not supported at this time.

Can I schedule posts? Posts publish with your configured status (draft or published). Use Shopify's built-in scheduling for timed releases.

---

Disconnecting

1. Go to Team Settings > Integrations

2. Click Disconnect on Shopify

Your existing content remains in Shopify. You can optionally delete the custom app from your Shopify admin.

---

Related Docs

• WordPress Integration

• Ghost Integration

• Webflow Integration