eCommerce · Admin API

Shopify

The Shopify integration connects VellumUp to your Shopify blog using a Custom App with Admin API access. Once set up, every article you schedule is automatically published — with its featured image, SEO metadata, and full formatting intact.

Overview

Article content

Full formatted article published to your selected Shopify blog

Featured image

Featured image uploaded to Shopify Files and attached to the post

SEO metadata

SEO title and meta description mapped to Shopify blog post fields

Scheduled publishing

Auto-publishes on the scheduled date from your Content Calendar

Requirements

Blog required: You must have at least one blog created in your Shopify admin before connecting. Go to Online Store → Blog Posts → Manage Blogs and create one if you haven't already.

Active Shopify store

Any Shopify plan works — Basic, Shopify, Advanced, or Plus.

Admin access

You need permission to create and manage Custom Apps in your Shopify admin.

At least one blog

Create a blog under Online Store → Blog Posts → Manage Blogs before connecting.

How to connect

Step 1 — Create a Custom App in Shopify

1
Go to Settings → Apps and sales channels
Log in to your Shopify Admin and navigate to Settings → Apps and sales channels.
2
Click Develop apps → Create an app
Click the Develop apps button, then Create an app. Name it something clear, like "VellumUp Integration".
3
Open Configuration
Go to the Configuration tab and click Configure next to Admin API integration.
4
Set the required permissions
Enable Read and Write access for: write_content, read_content, write_publications, read_publications, write_files, read_files.
5
Click Save
Save the configuration to apply the selected scopes.
6
Install the app
Go to the Install app tab and click Install app to confirm. The app is now active on your store.

Step 2 — Copy Your Credentials

1
Go to the API credentials tab
After installing, navigate to the API credentials tab inside your app.
2
Copy the Admin API access token
Click Reveal token once and copy the Admin API access token. This is shown only once — store it somewhere safe.
3
Copy the API Key and API Secret Key
Also copy the API Key (Client ID) and the API Secret Key (Client Secret) shown on the same page.

Note: The Admin API access token is shown only once. If you miss it, you'll need to uninstall and reinstall the app to get a new one.

Step 3 — Connect to VellumUp

1
Open Integrations → Shopify
In your VellumUp dashboard, go to Integrations → Shopify and click Connect.
2
Fill in your details
Enter a Store Name (a friendly label), your Author Name (how you want to appear on posts), your Store Subdomain (e.g. my-store from my-store.myshopify.com), your Client ID, and your Client Secret.
3
Click Connect
VellumUp will verify your credentials, fetch your blogs, and activate the integration.

Note: VellumUp automatically converts article content — including headings, tables, and lists — to clean HTML before publishing to Shopify.

Go to integration

Multilingual Support

VellumUp uses Shopify's Native Translations API to manage your multilingual content seamlessly — no duplicate posts, no manual setup.

Single-Post Architecture: Instead of creating duplicate posts for each language, translations are attached directly to your original article using Shopify's translation engine.
Zero Manual Setup: The system automatically enables and registers the required locales in your store settings — nothing to configure on your end.
Smart Storefront Delivery: Shopify automatically serves the correct language version — title, content, and table of contents — based on your customer's location and storefront settings.
View & Edit Translations in Shopify Admin: Install the free Translate & Adapt app from the Shopify App Store. It shows all language versions of your articles side by side and lets you review or edit them directly.

Troubleshooting

Issue	Solution
"Unauthorized" (401)	Make sure your Admin API access token is correct and the app is installed on your store.
Store not found	Check your subdomain. Enter only the handle without https:// or .myshopify.com — for example, my-store.
Images not loading	Verify that write_files and read_files permissions are enabled in your Shopify Custom App configuration.
Translation not visible to customers	Shopify may show a warning: "Not visible to customers because it's not in a market." Go to Shopify Admin → Settings → Markets, open the relevant market, and add the language there. Once added, the translated article will be accessible at its locale URL (e.g. /he/blogs/...).

Publishing behavior

When an article is published, VellumUp sends the full HTML content to your selected Shopify blog via the Admin API. The featured image is uploaded to Shopify Files first and then set as the article cover. SEO title and meta description are synced to Shopify's built-in SEO fields. Posts go live immediately on their scheduled date.

Back to Docs