Connect your OpenCart store
The Releva module for OpenCart (extension Releva, package Releva_Releva-x.y.z.ocmod.zip) puts the Releva tracking snippet on your storefront pages, with a page token per page type, and serves the endpoints Releva reads your product catalog and newsletter subscribers from. You install it in the OpenCart admin and configure it with keys and tokens you copy from Releva. In Releva itself you create the shop with platform OpenCart, copy the keys and tokens, and later check that data arrives.
Before you start
Section titled “Before you start”- A shop in Releva with Platform set to OpenCart. The platform is chosen on Create Shop and is read-only afterwards on Settings › Shop & Integration › General. Choosing it fills in the catalog, subscriber and unsubscribe URLs for you (see In Releva: check the sync settings). If your shop was created as Other / Custom, ask your account manager for an OpenCart shop. See How accounts, shops and billing work.
- The module zip from your Releva account manager.
- OpenCart 3.x, or 2.3 up to 3.0. For OpenCart 4, ask your account manager.
- An OpenCart admin user who may install extensions and modifications.
- Your shop runs on HTTPS and can reach
https://releva.aifrom its server. Releva calls your shop’s catalog and subscriber endpoints over HTTPS, and your server calls the Releva API. - A Releva page for each page type you want to personalize (home, category, product, cart, checkout, search, specials). See How product blocks work.
Install
Section titled “Install”1. Allow the installer to create folders (OpenCart 3 and 2.3)
Section titled “1. Allow the installer to create folders (OpenCart 3 and 2.3)”OpenCart 3 does not let extensions create new folders during installation, so the Releva module cannot install until that restriction is lifted. Skip this step if you have already disabled the directory restriction for extension installation.
-
Go to Extensions › Installer and select Upload.
Merchant platform (OpenCart admin).
-
Upload the installer fix for your version:
fixoc3installer.ocmod.zipfor OpenCart 3, orfixoc2installer.ocmod.xmlfor OpenCart 2.3 up to 3.0. Ask your account manager for the file. -
Go to Extensions › Modifications and select the refresh button in the top right. The fix appears in the list as Fix opencart 3 installer folder limitation.
Merchant platform (OpenCart admin). The fix is a third-party OCMOD by GeekoDev.
2. Install the Releva module
Section titled “2. Install the Releva module”-
Go to Extensions › Installer again and upload the Releva module zip.
Merchant platform (OpenCart admin).
-
Go to Extensions › Modifications and select the refresh button once more. Releva integration now appears in the list.
Merchant platform (OpenCart admin).
-
Go to Extensions › Extensions and choose Modules in the extension type list.
Merchant platform (OpenCart admin).
-
Scroll to Releva and select the green install (plus) button, then the blue edit (pencil) button.

Merchant platform (OpenCart admin).
The package also contains the extensions Releva Recommenders and Releva Banners. Install Releva first. If product blocks or banners do not show on your storefront after setup, install and enable the other two the same way.
Configure
Section titled “Configure”1. Copy your keys and tokens from Releva
Section titled “1. Copy your keys and tokens from Releva”Open Settings › Shop & Integration. On the General tab, copy Access Token and Secret Key with the copy icon next to each field. Guide: Find your Access Token and Secret Key.
Then collect one page token per page type from Personalization › Product Blocks: open the page selector, pick the page, and copy its Token: with the copy icon. One token per page serves both product blocks and banner blocks. If a page type has no Releva page yet, select New Page, name it and save it to get its token. The steps are the same as in Copy your page tokens for the WooCommerce plugin; the screenshots are in Verify.
2. Paste them into the module
Section titled “2. Paste them into the module”On Edit Releva Module (breadcrumb Home › Extensions › Releva), under Shop settings:
| Module field | Value |
|---|---|
| Status | Enabled |
| Shop Access Token | Access Token from Settings › Shop & Integration › General (older module versions call it the “access key”) |
| Shop Secret Key | Secret Key from the same tab |
| Name of cookie which stores user consent for data processing | The name of the cookie your consent banner sets when a visitor accepts, for example cookielaw |
| Value of the cookie which signifies that the user has given their consent for data processing | The value that means consent was given, for example 1. Optional: leave it empty to check only that the cookie exists |
| Product Image Width (px), Product Image Height (px) | Size of the product images the module reports in the catalog |
| Collect Push Notification Permissions | Enabled only if you send web push notifications from Releva. See Create a web push notification |
| Show out of stock products that can be ordered | Reports products that are out of stock but can still be ordered as available |

If your store is subject to data protection laws such as GDPR or CCPA, fill in the consent cookie before you save. A wrong consent configuration is your responsibility, not Releva’s. On every push the Releva SDK sends profile.consent as cookiesPolicy when the check passes and mandatoryCookies otherwise; how Releva treats each value is in How consent works in Releva.

Further down, paste one page token into each page section:
| Module field | Releva page |
|---|---|
| Home page Token | your home page |
| Category page Token | your category or listing page |
| Product page Token | your product page |
| Cart page Token | your cart page |
| Checkout page Token | your checkout page |
| Search page Token | your search results page |
| Specials page Token | your specials (offers) page |
Leave a field empty if you do not want personalization on that page type. Select the save icon (blue disk, top right).

Under Releva Integration, Check Releva status checks the keys against Releva and Product Sync starts a catalog sync. You can also start a catalog sync from Releva with Sync Now.
3. Other OpenCart pages
Section titled “3. Other OpenCart pages”To personalize a page that is not one of the seven types above, create a Releva page for it with New Page on Personalization › Product Blocks, copy its token, and add this snippet to the OpenCart page template, with your token in place of the placeholder:
<script>window.relevaPageToken = '<your_custom_page_token>';</script>The module’s own template reads this snippet, not the Releva SDK, so it depends on your module version. As a fallback that needs no snippet, set URL Path in the Releva page’s settings (the settings icon next to Token:): Releva then matches page views by path when no token is sent.
4. In Releva: check the sync settings
Section titled “4. In Releva: check the sync settings”When the shop was created with platform OpenCart, Releva filled in three addresses from the shop URL:
| Setting | Where in Releva | Default |
|---|---|---|
| Catalog sync URL (Catalog Sync Type API) | Settings › Shop & Integration › Catalog Sync | https://your-shop.example.com/index.php?route=extension/module/releva_products |
| Subscriber Sync API | Settings › Messaging › General, visible when Subscription Management is External | https://your-shop.example.com/index.php?route=extension/module/releva_subscribers |
| Email Unsubscribe URL | Same place | https://your-shop.example.com/index.php?route=account/newsletter (OpenCart’s own newsletter page) |
Two things are not set for you:
- Catalog Sync Schedule is empty. Releva presets a nightly schedule for Shopify shops only. Without a cron expression Releva never pulls your full catalog on its own; Sync Now starts one by hand. Follow Schedule a full catalog sync.
- Subscription Management defaults to Internal on Create Shop. In that mode the two subscriber fields are hidden. If OpenCart stays the record of who is subscribed to your newsletter, switch to External and save: Choose how Releva manages subscriptions.
If your store lives in a subfolder, or SEO URLs rewrite index.php?route=, edit the addresses so that they still reach the module’s routes.
Verify
Section titled “Verify”Check that Releva sees your OpenCart shop
Section titled “Check that Releva sees your OpenCart shop”Recorded in the Releva admin on a demo shop set up as an OpenCart shop, signed in as a regular user. Nothing is typed or saved. The shop name, URL, keys and token are masked.
-
Open Settings › Shop & Integration. On the General tab, Platform shows OpenCart or PrestaShop

-
Access Token is the public key. The OpenCart module asks for it next to the secret key. Select the copy icon next to it to copy it

-
Secret Key is the private key both modules ask for. Select the copy icon next to it to copy it, and keep it out of public pages

-
Select the Catalog Sync tab

-
With API selected, this is the address Releva reads your catalog from. For OpenCart it ends in
index.php?route=extension/module/releva_products, for PrestaShop inindex.php?fc=module&module=releva&controller=products&id_lang=1&ajax=true. Releva fills it in when your shop is created
-
Sync History lists each catalog sync with its status and product count. Last successful sync: Never means Releva has not read your catalog yet

-
For OpenCart, Settings › Messaging › General with Subscription Management set to External also shows Subscriber Sync API, the module’s newsletter-subscriber endpoint, and Email Unsubscribe URL, your shop’s newsletter page

-
The OpenCart module also asks for page tokens. Go to Personalization › Product Blocks, pick a page in the page selector and copy its Token: with the copy icon

Select Test next to the catalog address to make Releva request page 1 of your catalog endpoint with your secret key; the response, or the error, appears under the field. Select Sync Now to start a full sync; it appears in Sync History once it has run. Sync Now next to Subscriber Sync API does the same for subscribers.
Check that your shop’s data reaches Releva
Section titled “Check that your shop’s data reaches Releva”Open your shop in a browser and visit a few pages, view a product and add it to the cart. Then check Data Platform › Events, Data Platform › Products and Data Platform › Profiles in Releva. The screens are the same for every integration: Check that your store data arrives.
On Data Platform › Events, Page: names the Releva page whose token the module sent for that page type. A row with URL: View in browser but no Page: means the token field for that page type is empty or wrong. Other event types to look for once the module runs: Viewed Product, Cart Item Added, Cart Checkout Completed and Registered.
Troubleshooting
Section titled “Troubleshooting”Nothing appears on Data Platform › Events. Check that Status is Enabled and Shop Access Token equals the Access Token in Releva (not the Secret Key; both are UUIDs). Open the page source of your storefront and look for releva-sdk-js. If it is missing, refresh Extensions › Modifications again and clear OpenCart’s cache. If the snippet is there but no events arrive, and your consent cookie is configured, accept your cookie banner first. Use the tracking-snippet check to confirm the shop’s Access Token works.
Events arrive, but without Page: links. The module sends a page token per page type. Fill in the matching … page Token field, or set URL Path in the Releva page’s settings so Releva can match the page by path when no token is sent.
Test on the Catalog Sync tab fails. Releva calls GET <url>&page=1 with user-agent: Releva/0.0.1 and the secret key in both authorization and x-rlv-authorization: Bearer <secretKey>, and expects JSON with products and pageCount or nextCursor. The second header exists because Apache with PHP often strips the standard Authorization header; it was added for OpenCart shops. A 404 or an HTML page means the URL does not reach the module: check a subfolder or SEO URL rewriting of index.php?route=. An authentication error means Shop Secret Key differs from the Secret Key in Releva. The contract is in the catalog pull-sync reference.
Test fails with a 403 from your hosting. Some hosts and security extensions block unknown user agents. Releva’s requests identify as Releva/0.0.1; the agent was renamed from RelevaBot in 2024 because OpenCart hosts blocked it. Allow-list Releva/ and the two route=extension/module/releva_* URLs.
Products disappear from Releva after a full sync. About 120 seconds after a complete pass, Releva deletes every product the endpoint did not return. Disabled or out-of-stock products should still be returned with available: false; see Show out of stock products that can be ordered above and Full syncs delete what they do not see.
Sync History stays at Last successful sync: Never. No schedule is preset for OpenCart shops. Enter a cron expression under Catalog Sync Schedule or select Sync Now.
The module does not install, or its files are missing after install. On OpenCart 3 the installer fix from Install must be installed and Modifications refreshed before the Releva zip is uploaded.
Subscriber Sync API Test is disabled. In the current admin that button depends on the catalog sync URL, not on the subscriber URL. Use Sync Now instead.
Help links in the Releva admin open old documentation pages. The Catalog Sync tab links to /documentation/sync-apis/periodical-product-sync/ and the Email Unsubscribe URL help to /documentation/gdpr-identity-apis/unsubscribe/; their content is now in the catalog pull-sync reference and How consent works in Releva.
What syncs
Section titled “What syncs”What a module sends can change between module versions. If you depend on one of these calls, ask your account manager whether your module version makes it.
| Data | Direction and endpoint | When |
|---|---|---|
| Catalog, full | Releva pulls GET https://your-shop/index.php?route=extension/module/releva_products&page=&cursor= with user-agent: Releva/0.0.1, authorization and x-rlv-authorization: Bearer <secretKey>; the module serves this route |
Catalog Sync Schedule, Sync Now, Product Sync in the module, or POST /api/v0/products/sync |
| Product deletes | DELETE /api/v0/products/{id}, secret key |
On product delete |
| Catalog, incremental | POST /api/v0/products, POST /api/v0/products/availability |
On product save or stock change |
| Subscribers, full | Releva pulls GET https://your-shop/index.php?route=extension/module/releva_subscribers&page=&cursor= (same headers); each item is upserted as a profile with its subscribedAt |
Sync Now next to Subscriber Sync API, or POST /api/v0/subscribers/sync |
| Page views, product views, cart, search, the logged-in customer | Browser. The module renders the Releva SDK snippet with the page token for the page type; the SDK posts the page context to POST /api/v0/push/{accessToken} and receives the product blocks and banners for the page |
Every storefront page |
| Tracking consent | The module checks the configured consent cookie; the SDK sends profile.consent as cookiesPolicy or mandatoryCookies |
Every push |
| Web push subscriptions | The SDK registers a service worker and posts the subscription to POST /api/v0/pushSubscriptions/{accessToken} |
When Collect Push Notification Permissions is Enabled and the visitor accepts |
| Customers (registration) | POST /api/v0/register or POST /api/v0/profiles, secret key |
On registration |
| Newsletter consent | POST /api/v0/subscribe, POST /api/v0/unsubscribe, secret key (Releva calls these “the merchant plugins’ route”); the Email Unsubscribe URL default points at OpenCart’s account/newsletter page |
On newsletter opt-in or opt-out |
| Orders | SDK push with a paid cart on the success page, or POST /api/v0/carts with cartPaid and orderId |
On order placement |
| Order status changes | not sent | |
| Refunds | POST /api/v0/refunds |
|
| Personal data erasure | DELETE /api/v0/profiles, secret key (Releva calls it the merchant-plugin erasure endpoint) |
|
| Product blocks and banners | Rendered from the push response; the package ships Releva Recommenders and Releva Banners extensions | Every page |
Pushing changes keeps Releva current between syncs; the full sync is the safety net. See How Releva connects to your shop.