Getting started

Knowledge base

From connecting your store to your first import: putting Eruptian to work in four steps. Then: what you see in Discover, how Eruptian counts, how to delete your account, and how to set up the Shopify app in your store.

Step 1

Connect your Shopify store

Eruptian puts the products you import into your own Shopify store. To do that, you connect the store to your account once.

  1. Open Connect a store

    Log in and choose Connect a store in the dashboard.

  2. Create your own app in Shopify

    In your Shopify Dev Dashboard, create an app with the values the page shows: its name, the two addresses and the access scopes, with Use legacy install flow checked. It takes a few minutes, once.

  3. Fill in your app's keys

    Copy the Client ID and Secret of that app into the form, with your store domain, and click Connect. Shopify asks you to approve access; then you are back in the dashboard with your store in it.

Not working?

Shopify shows an error
Check that the redirect URL in your app is exactly the one on the page, and that Use legacy install flow is checked. Then connect again.
The store already belongs to another account
A store belongs to one Eruptian account. If that other account is yours, log in with it. If not, ask the owner of that account.

Step 2

Set up your AI key

Eruptian rewrites products with an AI provider you choose, on your own key. You pay that provider directly. Without a key, Eruptian rewrites nothing.

  1. Get a key from a provider

    Which providers there are, what they cost and where to find the key is in the API key guide. A few let you start for free.

  2. Add it to your account

    Go to Account. Under AI provider, choose your provider, paste the key into API key and click Save.

  3. Test it

    Click Test key. If your provider answers, it works. The model can stay on Provider default.

Not working?

The test fails
Check that you chose the right provider and that your account with that provider has credit. The API key guide says what to do for each error.

Step 3

The Eruptian Discover extension

With the Chrome extension you add competitors to Discover, straight from the Meta Ad Library. Eruptian then keeps track of their stores for you.

  1. Install it in Chrome

    The extension is coming to the Chrome Web Store. As soon as it is there, you will find the link here.

  2. Connect it to your account

    Open the extension and press Log in. In the Eruptian window that opens, click Connect. The extension gets no access to your password.

  3. Pick competitors in the Ad Library

    Search the Meta Ad Library and press the extension's button. Tick the stores you want to follow and choose the market and the audience. Nothing is saved that you haven't seen first. You will find them under Competitors.

Not working?

Revoke a connection
Under Account, at Chrome extension, every connected extension is listed with when it was last used. Revoke removes it.

Step 4

Import your first product

One link is enough. Eruptian fetches the product from a public Shopify store, rewrites it to your rules and puts it in your store.

  1. Open Import

    Choose your store in the dashboard and open Import. Leave Single on for one product. Collection imports a whole collection.

  2. Paste the link

    Paste the product page from the store you are importing from. Want to review the product first? Tick Import as a draft.

  3. Click Import product

    You see each step go by, from fetching the product data to rewriting and creating it. Then open the product in Shopify, or publish the draft under Drafts.

Not working?

The product was imported before
Then Eruptian does not make a second one. You get a link to the product that is already there.
The import stops at Rewriting
That is almost always the AI key. Test it in your account, as in step 2.

Further with Eruptian

Once your store is running

What Eruptian does, what the Discover screens show and how their figures come about, how you test and import a product, and how you delete your account.

Eruptian

What Eruptian does for your store

Eruptian follows the order you work in: discover what sells, import what you may sell, and make it sell in your store. The first two you do here on the website; the third is the Shopify app in your store.

  1. Discover what sells

    Under Discover you keep a register of Competitors, from Meta's Ad Library through the Chrome extension. New products shows every night what each of them put in their store, Ads keeps the ads you follow with how long they ran, and Products is your own test list.

  2. Import what you may sell

    Paste a link to a product or a collection from a public Shopify store. Eruptian fetches it, has AI rewrite the text to your rewrite rules on your own key, works out the price by your pricing rules and puts it in your store, with photos and variants.

  3. Make it sell with the app

    The Shopify app puts size charts, bundles, a cart drawer and swatches in your store. It stands apart from your account here: you install it in Shopify, and Shopify bills it.

Not working?

Do you need all of it?
No. Each part stands on its own. Start with your first competitor, with your first import, or with the app as soon as it is in the App Store.

Discover

New products: what you see, and how often it refreshes

New products shows, per competitor, what that store newly put in its store, with the day it published it. For that, Eruptian reads the product list of every store in your register each night.

  1. Follow a competitor first

    The list comes from Competitors. Put a store there with the Chrome extension from the Meta Ad Library; the night after, Eruptian reads its store for the first time.

  2. Choose a store and a period

    On the left are your competitors, with how much is new; on the right the products of the chosen store, with Published and the day. Under Period you choose 7 or 30 days. Under each store it says when Eruptian last looked.

  3. Test or import from here

    Every product has two buttons: Test this product puts it on Products, your test list; Import opens the importer with the link already filled in.

Not working?

A store says not readable or paused
That store does not let its product list be read, or did not answer. Eruptian tries again every night and stops after three failed nights. Try again makes it read the store again tonight.
The first night counts nothing as new
What Eruptian sees the first time is the starting point: we know when we first saw it, not when the store listed it. New is what appears after that.

Discover

Ads: what running time and reach tell you

Ads is your watchlist: ads you saved without judging them yet. The time an ad keeps running is the evidence; Eruptian checks it for you and writes down what it sees.

  1. Save an ad from the Ad Library

    In the Meta Ad Library, press the extension's button on an ad whose product you want to follow. It lands on the watchlist with the store, the country and the date you saved it.

  2. Read the running time

    Running counts from the ad's earliest start to the last check, and only days a check confirmed; the clock does not keep counting. Ads then → now puts the count when you saved it beside the count at the last check. An ad is Still running or Stopped.

  3. Reach and spend

    Reach is Meta's own measured figure for the EU. The spend beside it is an estimate: reach times a fixed price per thousand, with est. in front; for ordinary ads Meta publishes no amounts.

  4. Decide, and move it to Products

    If an ad is still running weeks after you saved it, that is a reason to test the product. To Products puts it on your test list; the row stays here, marked In Products.

Not working?

An ad says Status unreadable
Meta put no readable stamp on that card, so Eruptian does not say whether it runs. Such an ad counts towards nothing; open it through Ad Library to look yourself.
Stop following an ad
Stop removes the row, with the history of its checks. An ad that already went to Products stays there.

Discover

Test a product, then import it

Products is your test list: everything on it is there because you put it there. Discover is the market; the test list is your decisions, with the evidence beside them. When you decide to sell, you import from the same row.

  1. Put it on Products

    From Ads with To Products, from New products or a store with Test this product, or paste a Product link at the top of the list, say under How you found it where you saw it, and click Add product.

  2. Keep your decision

    Under Phase you set where the product stands, and under Why, in your own words, why it is worth testing. Ads running and Ad age come from the capture; Reach you type over yourself, because at Meta it sits behind a panel per ad.

  3. Import when you decide

    Choose once, under Import into, the store you import into. Import this product opens the importer with the link filled in; AI then rewrites the product on your key and Eruptian puts it in your store.

Not working?

There is no store to import into
Then you have not connected a store yet. Do that first under Connect a store; after that it is listed under Import into.
Reach says from 2 of 5 ads
Meta showed a reach for only some of this product's ads. The figure is then a floor: added up over what could be read, never topped up with a guess.

Discover

How Eruptian counts: at least, est. and when a figure is from

A figure in Discover says how sure it is and when it is from. Eruptian never fills in what it did not see: rather a floor or an empty cell than a guessed number.

  1. A floor says at least

    Ads are counted as they stood on the screen when you captured the store. Meta's own counter applies only when the search was one store; otherwise at least stands before the number the extension really saw, and a card without a readable stamp counts towards nothing.

  2. An estimate says est.

    Reach is measured, by Meta, for the EU. Spend is derived from it with a fixed price per thousand reach, which is why est. stands in front. An estimate is never shown as a measurement.

  3. Every figure says when it is from

    A count shows the day it was captured, a store when Eruptian last looked. First seen is when a scan of yours first saw something, never earlier than the store listed it; the first scan counts nothing as new. Days count only when a check confirmed them.

Not working?

Two figures for the same store differ
Meta counts per page and per store, and a store can advertise through several pages. The number on the row covers all pages; the row's explanation says how many pages that is.
A figure is missing
Then Eruptian could not read it or has not captured it yet. A new capture with the extension, or the next night, fills it in; Eruptian does not guess.

Account

Delete your account, and what happens to your stores

You delete your account yourself, at once and for good. Your research and your import history go with it; the products you imported stay in your stores, and the Shopify app keeps working.

  1. Open Delete account

    Go to Account settings and choose Delete account… at the bottom; it has a page of its own, so you never land on it by accident.

  2. Read what goes and what stays

    Gone are your research, your AI keys and the extension's connections, the connection with your stores with the import history, and your login details. With your stores stay the products you imported, and the Eruptian app with its bundles, size charts, swatches and cart drawer: it does not belong to this account.

  3. Confirm with your address

    Type your account's email address, and your password if you have one, and click Delete my account for good. You are logged out at once; there is no waiting period and no way back.

Not working?

You want the app gone too
Then remove the app in your Shopify admin, like any other app. Shopify then asks us to erase that store's data, and we do.
You have a running subscription
A Pro subscription is cancelled at once; for the rest of the period you get no money back. The invoices stay with our payment provider, because the law obliges us to keep them.

In your Shopify store

The Shopify app

Eruptian's app for Shopify puts size charts, swatches, bundles and a cart drawer in your store. You install it from Shopify and work with it in your Shopify admin; these five articles follow its screens, with the words they use.

Your theme

Put the app in your theme

The app reaches shoppers through your theme: the Size chart and Variant swatches blocks on the product page, and three app embeds, Eruptian Cart, Eruptian Bundles and Eruptian Swatches, for the cart drawer, the bundle bars and the swatches on product cards. Nothing changes in your store until you press Save in Shopify's theme editor.

  1. See what is on

    Open Eruptian in your Shopify admin. On Home, under In your theme, you see the Size chart block, the Cart drawer and Bundle deals, each as Live, Not added or Switched off.

  2. Let the app open the theme editor

    Click Add it or Switch it on next to a part that is not live, or Open theme editor on that part's page. The editor of your live theme opens with the step already done: the Size chart block added to the product page, or the embed switched on under App embeds. The Variant swatches block you place yourself; the Swatches article says where.

  3. Save, then come back

    Check where the block or embed sits and press Save. Back in Eruptian, the page reads your theme again by itself and the status turns to Live; if it has not, reload the page.

Not working?

The status says Unknown
Eruptian could not read your theme just now; it does not mean the setup failed. Reload the page a little later, or open the theme editor yourself under Online Store, Themes, Customize.
Nothing shows in the store
A block or embed shows only what has content: no size chart on a product without a linked chart, no swatches before the first sync, no bars on a product outside every active bundle. The article of that part says what to check.

Size charts

Show a size chart on your product pages

A size chart opens from a link on the product page, in a popup or as a table on the page itself. You make the chart in the app, link it to products, and put the Size chart block in your theme once.

  1. Make the chart

    Under Size charts, click Add size chart and choose how to start: Blank, An image, From CSV / Excel, A PDF, A web page, A product in this store, or a ready-made garment type. Blank, From CSV / Excel and the garment types need no AI key; an image, a PDF or a web page is read by AI on your own key.

  2. Link it to products

    Open the chart and choose products under Linked products, or set rules under Automatic matching, by tag, product type, vendor or collection, and press Sync to products so the products already in your store follow. A product has one chart; one linked by hand wins over a rule.

  3. Put the block in your theme

    In the guide on the Size charts page, click Open theme editor at Add the block to your theme. The product template opens with the Size chart block added; move it under the variant picker and press Save. Once is enough for every product on that template.

Not working?

No size chart on the product page
A chart shows only on a product it is linked to, and only where the block stands. In the theme editor, a product without a chart shows a note that says so; shoppers never see that note.
The AI read the chart wrongly
Check the table and correct it before you save. The unit, cm or inch, never comes from the source: you choose it. Blank and From CSV / Excel take your own numbers as they are.

Swatches

Show colours as swatches

Swatches turn your theme's variant picker into circles, squares, product photos or buttons, on the product page and on product cards. They work your theme's own picker, so price, photo and stock follow as before; where they cannot work it, they step aside and the theme's picker stays.

  1. Map your option names

    Under Swatches, click Map option names. The page lists the option names your products use, such as Color or Size, each with a suggested group; you map each name to a group. Open a group to choose its look and its colours.

  2. Add the block, then sync

    Click Open theme editor at Add the block to your product page, add Variant swatches from the Apps group right above the variant picker, and press Save. Then press Sync to products: only the first sync puts the swatches on your products.

  3. Show swatches on product cards

    At that step, click Open theme editor: App embeds opens with Eruptian Swatches switched on. Press Save. Collection and search pages then show up to five swatches per card, for groups whose look shows colours or photos.

Not working?

The swatches do not show
Check that the option name is mapped and that you synced after mapping. When the swatches cannot work your theme's picker for every option, they step aside: in the theme editor a note says why, and shoppers keep the theme's picker.
A change does not show yet
A change to a group's look or colours reaches your store at the next Sync to products; until then the page says your store still shows the last sync. New and edited products get their swatches by themselves.

Bundles

Sell more with a bundle

A bundle puts bars on the product page, such as one, two or three pieces with a growing discount, and your checkout gives that discount by itself. You never make a discount by hand: the app keeps one automatic discount up to date for all your bundles.

  1. Choose a kind of bundle

    Under Bundles, click Add bundle deal and choose Volume discount, Buy X, get Y, Multi-product pack or Complete the bundle. Volume discount and Buy X, get Y start with bars you can change.

  2. Choose the products

    For a volume discount or Buy X, get Y, open Products in the editor and choose All products, Selected products or Selected collections, with Leave out for exceptions; a pack or a set gets its own products in the editor too. A bundle without products is on but reaches nobody. A First day and a Last day are optional.

  3. Switch it on and save

    Switch the bundle to active in the top bar and press Save deal: the switch alone is not enough. Then, once, click Open theme editor at Turn on the app embed in your theme and press Save, so the bars show on your product pages.

Not working?

No bars on a product
Check that the bundle is active and saved, that the product is in it, and that the app embed is on. A bundle marked Scheduled has not started yet, and one marked Ended is past its last day: neither shows bars.
The checkout counts otherwise than the bars
Bars and checkout come from the same saved bundle and match to the cent; a bundle you changed but did not save still shows the old bars. A fixed amount off works only when the shopper pays in your store's currency; otherwise the bars leave it out.

Cart

Turn on the cart drawer

Eruptian's cart drawer slides in when a shopper adds a product, instead of your theme's cart: the lines with buttons for the quantity, the subtotal and the checkout button, and what you switch on, such as a free shipping bar, upsells or a discount code field.

  1. Design your cart

    Under Cart, the app has made a Standard cart for you and put it live. Click Customize drawer to choose its parts and write its texts, with a live preview on your own products.

  2. Turn on Eruptian Cart in your theme

    Click Open theme editor at that step: App embeds opens with Eruptian Cart switched on. Press Save. From then on, what you change in the app follows by itself.

  3. Turn off other cart apps

    If another cart drawer app is on in your theme, the guide names it. Leave it on until Eruptian's drawer is live, then switch it off, so a shopper sees one cart.

Not working?

The theme's own cart still opens
Check that Eruptian Cart is on under App embeds and that you pressed Save there, and that the live cart on the Cart page is switched on: switched off, the drawer shows nothing.
The drawer speaks another language than my store
The drawer's own words, such as Subtotal and Remove, come in English, Dutch, German, French and Spanish. The texts you write start in English; under Customize drawer, Languages, Add a language you give them in another language, typed or translated with your own AI key.

Your question isn't here?

Have a look at the frequently asked questions, or get in touch.