Nuwtonic AI SEO Agent Logo
Nuwtonic

Integrations

Connect Admin API access, add the theme schema snippet, and publish SEO updates to Shopify.

Shopify Integration Guide

Connect Shopify so Nuwtonic can sync products and pages, publish content, and apply SEO meta and schema updates through Admin API access and a theme snippet.

Related docs: User Guide · Shopify help: Get API access tokens

1. What this integration does

With Shopify connected, Nuwtonic can:

  • sync products and pages from your store;
  • publish generated content into Shopify where supported;
  • write SEO-related metafield values used for meta and JSON-LD schema;
  • keep one active CMS connection for the workspace.

You connect with:

  1. Shop domain (for example store.myshopify.com)
  2. Admin API access token
  3. Theme Liquid snippet for meta and schema output

2. Before you start

  1. You are a store owner or staff member who can create and install apps.
  2. You can edit theme code under Online Store → Themes.
  3. You know the store’s .myshopify.com domain.
  4. No other CMS integration is active on the same Nuwtonic workspace.

Only one CMS integration can be active per workspace. Disconnect WordPress, Ghost, Webflow, or Webhook before relying on Shopify if another platform is currently connected.

3. Create app credentials in Shopify

Shopify app setup has moved toward the Dev Dashboard and short-lived tokens. Use the flow available in your store admin.

Option A — Develop apps in Shopify Admin

  1. Open Shopify Admin.
  2. Go to Settings → Apps and sales channels → Develop apps.
  3. Allow custom app development if Shopify asks you to.
  4. Create an app named something clear, such as Nuwtonic.
  5. Configure Admin API scopes. Enable read and write access for the resources you need Nuwtonic to sync and update. Recommended starting set:
    • products
    • content / online store pages and articles when available
    • metafields
    • themes (if required for your store setup)
  6. Install the app on the store.
  7. Reveal or generate the Admin API access token.
  8. Copy the token immediately and store it in a password manager. Treat it like a password.

Option B — Dev Dashboard client credentials

If Shopify shows a Client ID and Client secret instead of a static token:

  1. Create and install the app for your own store.
  2. Exchange the client credentials for an Admin API access token using Shopify’s client credentials grant.
  3. Paste the resulting access_token into Nuwtonic.

Official reference: Get API access tokens for Dev Dashboard apps.

Important:

  • Tokens may expire. If Nuwtonic later reports a connection failure, generate a fresh access token and update the integration.
  • Client credentials grant works for apps installed on stores you own. Partner apps for other merchants need a different OAuth path.

4. Connect Shopify in Nuwtonic

  1. Open the workspace.
  2. Go to Integrations.
  3. Find Shopify and select Connect.
  4. Enter the Shop domain (example: your-store.myshopify.com).
  5. Paste the Access token.
  6. Select Connect.
  7. Wait for Nuwtonic to validate the credentials.

Do not include https:// in the shop domain field unless the form explicitly asks for a full URL. Use the myshopify hostname shown in Shopify Admin.

5. Enable meta and schema in the theme

Nuwtonic stores JSON-LD schema in page and article metafields. Your theme must print those metafields in the document head.

  1. In Nuwtonic Integrations, use Copy Code (Meta & Schema) or copy the snippet below.
  2. In Shopify Admin, open Online Store → Themes → Edit code.
  3. Open theme.liquid (or the main layout file).
  4. Paste this inside <head>, before the closing </head> tag:
{% if page.metafields.seo.json_ld_schema %}
<script type="application/ld+json">
{{ page.metafields.seo.json_ld_schema }}
</script>
{% endif %}

{% if article.metafields.seo.json_ld_schema %}
<script type="application/ld+json">
{{ article.metafields.seo.json_ld_schema }}
</script>
{% endif %}
  1. Save the theme.
  2. Publish the theme if you edited an unpublished copy.

Without this snippet, metafield values may be saved but visitors will not see the JSON-LD in page source.

6. Confirm the connection is working

  1. Integrations shows Shopify as Connected.
  2. Sync or open Content Generation and confirm store pages or products are available where expected.
  3. Publish a test update to a low-risk page or article.
  4. View page source and confirm the JSON-LD script appears after schema is written.
  5. Re-check the live URL in a private browser window.

7. Troubleshooting

Connection failed

  • Confirm the shop domain is exact (store.myshopify.com).
  • Confirm the access token belongs to that same store.
  • Confirm the app is installed and the token was not revoked.
  • Generate a new token if the previous one expired.

Insufficient permissions

  • Re-open the app’s Admin API scopes.
  • Add missing read/write scopes for products, content, metafields, and themes as needed.
  • Reinstall or update the app, then paste a new token into Nuwtonic.

Schema not visible on the live page

  • Confirm the Liquid snippet is in the published theme’s <head>.
  • Confirm you edited the live theme, not only a duplicate.
  • Confirm Nuwtonic wrote the metafield for a page or article resource.
  • Hard-refresh or open a private window to bypass cache.

Wrong store connected

Disconnect Shopify in Nuwtonic, then reconnect with the correct shop domain and token.

8. Production checklist

  • App installed on the correct store
  • Required Admin API scopes enabled
  • Access token stored securely and pasted into Nuwtonic
  • Shopify shows as Connected
  • Theme snippet added inside <head>
  • Test publish or SEO update verified on a low-risk URL

9. Next steps