Setup 6 of 14
Create a Shopify Dev Dashboard app and connect your store
If your store runs on Shopify, Get1pct can apply the edits you choose with “Use this edit” straight to your store. It changes the search listing (SEO title and description) of products, collections, pages and blog articles, and the title of pages and blog articles. To connect, you create a small app in the Shopify Dev Dashboard, install it only on your own store, and enter the app’s Client ID and Client secret in Get1pct.
- Required?
- Optional (Shopify only)
- Where you do it
- Shopify Dev Dashboard
Before you start
- You need to be the store owner, or use an account that is allowed to create apps (for example, with the App developer permission).
- Create the app in the Dev Dashboard of the organization that owns the store. An app from another organization can’t connect this way.
- The site you registered in Get1pct must be the store’s primary domain or its xxx.myshopify.com address.
- Connecting is optional. Without it, you copy the wording of each edit and paste it into Shopify yourself.
- Each site can have one connection. If WordPress is connected to the same site, connecting Shopify replaces it.
- This page has no Shopify screenshots because we don’t have a test store. The steps follow Shopify’s official documentation.
Scopes to grant
Give the app these two Admin API scopes and nothing else. A write scope includes read access, so you don’t need any read_ scopes.
write_productslets Get1pct find products and collections and change their SEO title and description (stored in Shopify’s SEO metafields). It never changes product names.write_contentlets Get1pct find pages and blog articles and change their title, SEO title and SEO description (through pageUpdate, articleUpdate and the SEO metafields).write_online_store_pagesalso works in its place.
If you only want edits for products, or only for pages and articles, the matching scope is enough. Don’t grant scopes for orders, customers, themes, files, inventory or discounts.
To learn how to store the Client secret and what to do if it may have leaked, see Keep API keys and CMS tokens safe.
Steps
Step 1Create an app in the Dev Dashboard
- Open the Shopify Dev Dashboard (
dev.shopify.com). You can also get there from Settings → Apps in your Shopify admin. - On the Apps page, click Create app at the top right and choose Start from Dev Dashboard.
- Enter a name you will recognize, such as get1pct, and click Create.
Step 2Add the scopes and release a version
- Open Versions and enter
write_products,write_contentin Scopes. Fill in the other fields as the screen asks. - Click Release. You can’t install the app until it has a released version.
Step 3Install it on your store
Click Install app, choose your store and click Install.
Step 4Copy the Client ID and Client secret
Open the app’s Settings. Copy the Client ID and the Client secret from the Credentials card.
Treat the Client secret like a password. Don’t paste it into emails or chats.
Step 5Enter them in the dashboard and click Connect
Open Connections in your dashboard. Under “How your site is updated”, choose “Shopify, Webflow, Contentful, microCMS or another service”. The dashboard in the screenshot is in Japanese, so each step below it gives the English label in brackets.

- Choose “Shopify” in “お使いの CMS” (Your CMS).
- Enter the xxx of xxx.myshopify.com in “ストアのドメイン” (Store domain).
- Leave “認証の方法” (How to authenticate) as “Dev Dashboard のアプリ” (Dev Dashboard app).
- Paste the app’s Client ID into “Client ID”.
- Paste the app’s Client secret into “Client secret またはトークン” (Client secret or token).
- Click “接続する” (Connect).
The connection is done when the screen shows “Connected”. If “Notes from connecting” appears, read it. It appears, for example, when the app has only one of the two scopes.
If you have a custom app that was created in Shopify admin before January 2026, its token (starting with shpat_) also works. Check that the app has the same scopes, set “How to authenticate” to “Existing custom app (shpat_)” and paste the token. Shopify admin no longer lets you create new custom apps.
How this connection behaves
Get1pct follows these rules every time it applies an edit through this connection.
- We only change the title tag, meta description and heading (h1), and only in the fields you listed when connecting. We never change body text.
- We change a field only when its current value is exactly the same as the edit’s “before” text (the text on the live page). If it differs at all, it’s a different entry or your site adds words (such as “| Site name”), so we leave it for you to copy.
- We don’t write an edit whose new text is the same as before, longer than 2,000 characters, or contains < > [ ] or control characters (a CMS may read them as tags or shortcodes).
- Before writing we record which field changes from what to what, and after writing we read it back. If the saved value differs, we put the old value back and report a failure.
- If a write is interrupted, we read the current value next time: if it was written we’re done, if it’s unchanged we continue, otherwise we report a failure. We never write the same change twice.
- Undo puts the old value back only while the field still holds the value Get1pct wrote. If someone has edited it since, we leave it.
- We only call the CMS’s official API host. We don’t follow redirects, give up after 15 seconds and don’t read responses over 2 MB.
- For every type of page, Shopify stores the SEO title and description in its SEO metafields (global title_tag and description_tag). Get1pct sends only the one it changes and never resends the other, so it can’t overwrite a change someone makes to the other one at the same time.
- Get1pct writes only in the store’s primary language. Edits for translated pages (such as /en/products/…) are left for you to copy.
To compare Shopify, Webflow, Contentful and microCMS side by side, see what each CMS connection can do.
Check the connection
Once connected, use “Check the connection” under the CMS in Connections. Enter the URL of one live article or item page.
- Read test: we find the CMS entry and show, for the title, description and heading, whether the CMS value is exactly the text on the live page. Only those fields are updated automatically; for the others the table shows why. Nothing is changed.
- Write test: we write the current value of one field that can be updated back into it as is, and read it back. The live page doesn’t change. If the token can’t write, or your CMS changes the text when saving, the result says so.
Run the read test first, then the write test. If the write test says the next edit can’t be applied, publish the site (or entry) in your CMS and let us know.
After connecting
- Get1pct works with products (/products/…), collections (/collections/…), pages (/pages/…) and blog articles (/blogs/…/…). It finds the right one from the page URL.
- For pages and blog articles, a heading (h1) edit changes the page or article title. For products and collections, the heading is the product or collection name, which also appears in orders, emails, Google Shopping and other places. Get1pct doesn’t change it automatically. If you want the edit, copy it and apply it yourself.
- Get1pct changes a field only when its current value exactly matches the text on your live page. The change appears on your live store right away. To reverse it, click “Undo the change” on that edit in the dashboard.
- If the SEO title or description is empty in Shopify, Shopify shows its own text on the live page instead. The empty field doesn’t match that text, so you copy the edit and apply it yourself. The same goes for pages not listed above, such as the home page.
- App tokens expire after 24 hours. Each time Get1pct applies an edit, it gets a new token with the Client ID and Client secret, so you don’t have to do anything.
Troubleshooting
- “We could not connect.”
- Check the store domain (the xxx in xxx.myshopify.com), the Client ID and the Client secret. Then check that the app is installed on the store, that you released a version with the scopes, and that the app and the store belong to the same organization. Connecting also fails if the site you registered isn’t the store’s primary domain or its myshopify.com address.
- Products update but pages or blog articles don’t
- Check that the app has write_content (or write_online_store_pages). After you change the scopes, release a new version. Then click Disconnect and connect again, because Get1pct reads the app’s scopes when you connect.
- It says “Reconnect needed”
- Get1pct can no longer get a token, for example because the app was uninstalled or the Client secret was regenerated. Check the Client ID and Client secret, click Disconnect, and connect again.
- An edit isn’t applied automatically
- To be safe, Get1pct leaves an item alone when its SEO field is empty or its value differs from the live page. The edit screen shows how each edit will be applied.
To stop
Click “Disconnect” under Connections in your dashboard. Get1pct deletes the Client secret it stored. The app stays in Shopify, so also uninstall it under Settings → Apps in your Shopify admin, or delete it in the Dev Dashboard. Once it is uninstalled, the app can no longer read or change your store.
Guides for other CMSs: Webflow, Contentful and microCMS.
If the steps don’t match what you see, contact us with your site URL and the screen where you got stuck. Please don’t send passwords.