Shopware 6

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 Shopware 6 as the Platform and choose your Currency.

  4. Click Add Store.

2. Configure the Shopware 6 Connection #

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

  2. The my.clerk.io setup guide shows what you need to do in your Shopware 6 backend. Here is an outline of the steps:

  3. In the Shopware backend, go to Settings > System > Integrations

  4. Click Add integration

  5. In the popup, write Clerk.io as the name and enable Administrator

  6. Copy the Access key ID and the Secret Access Key to the respective fields in my.clerk.io

  7. Click Save integration

3. Sync your store #

  1. In my.clerk.io, add your Store URL to the field in the importer. This is is usually your domain e.g. https//yourdomain.com

  2. Add your Language Name to the field. If you are unsure what it is, you can find it in the Shopware backend under Settings > Shop > Languages. Use the text in the Name column.

  3. Add your currency ISO code. If you are unsure what it is, you can find it in the Shopware backend under Settings > Shop > Currencies. Use the text in the Short name column.

  4. In my.clerk.io, scroll down and click Start sync. Maybe have a cup of coffee if you have a big product catalog ;)

  5. That’s it!

Full Installation Example #

In this video you can get a complete overview of what it takes to set up Clerk.io on a Shopware 6 webshop.

Multiple languages #

Shopware uses Language IDs to identify each unique language in the webshop. These are not visible in the Shopware backend, so they have to be found through the frontend HTML.

Check this video to see how to identify the language IDs.

The best way to handle multi-language in Clerk is to create unique Stores for each language and sync it with the correct Language ID.

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

  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 your existing store(s) and your company name):

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

  1. Fill in the details of your webshop, 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.

  2. Now you can follow the Setup Guide again, to activate Clerk.io  by clicking on Getting Started, to Sync Data for this language. Remember to use the correct Language ID as described in the video in the top of the guide. The Store URL, Access Key, and Secret Access Key will be the same for all Stores.

  3. When Data Sync has finished, your webshop is ready and is using the same setup as your main Store.

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

    You can follow this process for all the languages of the webshop you want to use Clerk.io with.