Install through API - Shoper

Log in and Create a Store in Doofinder

1. Log in to your Doofinder Admin Panel and click "Create Store".

If you are new, a "Create store" button will appear on the front page. If you don't see it, or prefer another method, go to the top navigation bar, click the Store dropdown menu, and select "Create Store".

2. In the Create Store pop-up window, enter your website URL and select the platform you are using. Usually, Doofinder identifies the Shoper platform automatically.

3. Click “Continue”, now you will need to fill the Settings URL and the API Token fields. Do not close Doofinder during this process.

Complete the Settings URL

4. Go to your Shoper store's URL and add "/admin" to the end to access your Shoper admin panel.
5. Copy the URL from the browser address bar (it doesn’t matter which section of the admin you are in), and paste it into the Settings URL field in Doofinder.


Create a Doofinder Integration in Shoper

To generate the access token, follow these steps:

6. In the Shoper Admin, from the left-side menu, go to Dodatki i integracje (Additives and integrations).
7. Click Integracje zewnętrzne (External integrations) > in the top-right corner, access “Dodaj integrację” (“Add Integration”).

8. You will be directed to the Nowa integracja (New integration) settings panel. Fill in the following fields:
• In Podstawowe (Basic) > Narzędzie (Tool) > select Inne (Other)
• Choose an Nazwa integracji (Integration name). For example, use “Doofinder”.


Manage API Permissions

9. In this same panel, under the Uprawnienia integracji (Integration permissions), enable and save the following permissions:

Select Odczyt (Read-only permissions) for these scopes:

• atrybuty produktów (product attributes)
• stany dostępności (availability statuses)
• kategorie (categories)
• waluty (currencies)
• producenci (manufacturers)
• produkty (products)
• kolekcje (collections)
• aktualności/blog (news/blog)
• języki i lokalizacja (languages and location)
• strony informacyjne (informational pages)
• warianty produktów (product variants)

Select odczyt + dodawanie + edycja + usuwanie (full permission: read, create, update and delete) for:

• webhooki (webhooks)

You should now have a total of 12 accepted scopes.

Click "zapisz i utwórz token" (“save and create token”).



Add the API Token

10. Once generated, copy only your API Token > return to your Doofinder Admin Panel > paste the token into the API Token field, and click “Continue”.

Additionally, in your Shoper Admin, click "Rozumiem" ("Accept") to finalize the integration setup.

If you leave this page without copying the token, you can generate a new one by going to Dodatki i integracje (Additives and integrations) > Integracje zewnętrzne (External integrations).




Click the configuration button for the Doofinder integration > select “Utwórz nowy Token API” (“Create a new API Token”). Confirm again by clicking “Utwórz nowy Token API” (“Create a new API Token”) in the pop-up window.

Add the Doofinder Installation Script in Shoper

To finish the integration, copy the Doofinder script shown in the pop-up.

If you leave the process at this point, you can later retrieve the script from the Doofinder Admin Panel, under Configuration > Store Settings > Installation Script.


11. Go to Shoper > in the left-side menu, click Dodatki i integracje (Additives and integrations) > select Integracje własne (Custom integrations).
12. Scroll down to Nagłówek strony (Page header) > paste the Doofinder script, and click “zapisz” (“save”).

You can also install the script via Google Tag Manager (GTM) if if that is your preferred method. Check out this troubleshooting guide for a simple setup.



Go back to your Doofinder Admin Panel. Once indexation is completed, your store will be ready to use Doofinder.