Shopify

Get Started

Connecting your Store #

The first step of installing Clerk.io, is connecting your store with your Clerk.io account.

The video belows shows you what to do, step-by-step. Use the rest of the guide as a reference :)

After following these simple steps you will be able to see your Live Demo Store, which gives you a personal overview of how Clerk.io will work on your webshop. Reach out to your Clerk.io contact person to see the Live Demo.

1. Add Store #

  1. Login to my.clerk.io. The first time you do this, you will see the Add New Store page.

  2. Write the Name and Domain of your webshop

  3. Choose Shopify as the Platform and choose your Currency.

  4. Click Add Store.

2. Configure the Shopify Connection #

  1. From the main menu of the Setup Guide, click Sync your data

  2. This setup guide shows what you need to do in your Shopify backend. Here is an outline of the steps:

  3. In the Shopify backend, and go to Apps > App and sales channel settings > Develop apps

  4. Click Create an app in the top right corner

  5. Give the app a name like “Clerk.io” and select yourself as the App developer.

  6. Click Create app

  7. Click Configuration and find Admin API integration. Click Configure

  8. Under Admin API access scopes, select Read access (starts with “read_”) for the following:

  • Customers
  • Inventory
  • Online Store Pages
  • Orders
  • Products
  • Store Content
  1. Click Save.

  2. Click Install App and then Install in the popup that shows.

  3. Click the API Credentials tab.

3. Sync your store #

  1. Now copy-paste all the necessary info into the fields in my.clerk.io:
  • Shopify Domain (yourdomain.myshopify.com)
  • API key
  • Admin API access token
  • API Secret Key
  1. Click Start Sync. Wait for the sync to finish. Maybe have a cup of coffee if you have a big product catalog ;)
  2. That’s it!

Full installation Example #

Shopify has updated the way Private Apps are added. We are working on a new version of the video. Until then, see how to add a Private App here.

In this video you can get a complete overview of what it takes to setup Clerk.io on a Shopify webshop.

Multiple domains/languages #

The easiest way to implement Clerk.io in multiple domains in standard setups is by creating a separate Store for each domain in my.clerk.io, and then syncing them with each of your Shopify language domains.

This way, you can separate products, sales, currencies etc. to keep track of each domain.

  1. Start by creating your main Store and follow the Setup Guide to connect your Store to Clerk.io, and choose the Recommendations and/or Search Results you that you want to display on your webshop.

  2. When you are done with the initial setup, go back to the start page of my.clerk.io (by clicking the Clerk.io logo in the upper left side corner of the side-menu) and then click "+ Add new store" the last option of the scroll down list (generally under you the existing store(s) and your company name):

3. On the Add New Store page, click Advanced to see all settings.

4. Fill in the details of your domain, and choose your main Store from the

Copy Content From Existing Store dropdown, then click Add Store.

This will carry over the Content and Designs from your main Store.

5. Now you can follow the Setup Guide again, to activate Clerk.io by clicking on Getting Started, to Sync Data for the new domain.

6. This will allow you to sync your domain with your Store at my.clerk.io through

the Setup Guide.

7. When Data Sync has finished, your domain is ready and using the same

setup as your main Store.

8. Repeat this process for every one of your Shopify language domains,

Remember to translate Headlines, in Content-> Edit -> Select Design to the right language as well.

If you have a singular store with multiple inventories and language, then you will need to create multiple Clerk.io Apps in order to ensure quick data sync. This is done so a number of stores do not share the same rate limit and restore rate in the Shopify ADMIN API.

  • In the Shopify backend, go to Apps → Develop apps for your store.
  • Click the Create an app button.
  • Give the app a name like “Clerk.io” along with a name of the other e.g. “Clerk.io (EN)” and select App developer. Repeat this until you have equivalent “Clerk.io” apps to the number of subdomains for the shop.
  • Click Create app.
  • Click Configuration and find Admin API Integration. Click Configure.
  • Under Admin API Access scopes, select Read access (starts with “read_”) for the following:
    • Products
    • Orders
    • Customers
    • Inventory
    • Online Store Pages
    • Store Content
    • Translations
    • Markets
    • Locales
    • Price Rules
    • Publications
  • Click Save at the top of the screen.
  • Click Install App and then Install in the popup.
  • Click the API Credentials tab.
  • Now copy your stores Shopify Domain(s) and the private apps API Key, Access Token and Secret Key into the fields under Data Sync Settings in my.clerk.io.
  • Choose a Default image size and click Start Sync. Wait for the sync to finish. Maybe have a cup of coffee if you have a big product catelog.