Get Started

Get Clerk up and running on your Magento 1 store in just a few steps. This guide walks you through connecting your store, installing the extension, and syncing your data.

Connecting your store #

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

The video below 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 will work on your webshop. Reach out to your Clerk contact person to see the Live Demo.

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

4. Click Add Store.

Install extension #

1. Download the latest Clerk extension for Magento 1 from GitHub: Latest release.

   Alternatively, install using our Toolbox Script: Install via Toolbox Script.

2. In your Magento backend, go to System > Magento Connect > Magento Connect Manager.

3. Under Direct package file upload, upload the ClerkForMagento-x.x.x.tgz file and click Upload to install.

4. Click Return to Admin, then Log Out and log back in.

5. Go to System > Configuration and select the correct Current Configuration Scope (the Store View you want to sync).

6. Open Clerk > Configuration in the side menu.

7. Set Enable to Yes.

8. Enter your Clerk Public Key and Private Key, then click Save Config.

Keys location #

Your Public Key and Private Key are in my.clerk.io > Developers > API Keys.

Sync data #

1. In the Magento extension, copy the Import URL for your store.

2. Go to my.clerk.io > Data > Configuration and paste the Import URL into the Import URL field.

3. If you plan to use Email & Audience, set Collect Emails to Yes in the Magento extension and Save.

4. Select the language for your domain if applicable.

5. Click Start Sync and wait for the sync to complete.

Full installation example #

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

Multiple storeviews #

The easiest way to implement Clerk in multiple Storeviews in standard setups is by creating a separate Store for each domain in my.clerk.io.

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

1. Start by creating your main Store and follow the Setup Guide to connect your Store to Clerk, and choose the Recommendations and/or Search Results 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 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 Store page, click Advanced to see all settings.

4. Fill in the details of your Storeview, and choose your main Store from the Copy Elements From Existing Store dropdown, then click Add Store.

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

5. Now you can follow the Setup Guide again - by clicking on Getting Started, to Sync Data from this Storeview. As you have already installed the extension you can skip the first step and directly start configuring it and syncing data.

6. In the Magento backend, on the Clerk Extension page, choose the Storeview from the Current Configuration Scope dropdown.

7. This will allow you to sync the Storeview with your Store at my.clerk.io through the Setup Guide.

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

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

You can follow this process for all Storeviews you want to use Clerk with.