Ekoo Documentation

Add audio widgets to your e-commerce site

Ekoo allows you to add audio players directly to your product pages. Your customers, ambassadors or teams record voice capsules that enrich the shopping experience. The widget integrates in a few lines of code and displays automatically as soon as audio content is published for a given product.

How It Works

Create audio content in the Ekoo backoffice and associate it with a product.
Publish the audio — the widget only displays if at least one audio is published.
Add the code to your site: an <ekoo-widget> element with data-ekoo attributes + the official script.
The widget appears automatically for your visitors.

Minimal example

html

1<ekoo-widget
2  data-ekoo="YOUR_WEBSITE_ID"
3  data-ekoo-product-id="YOUR_PRODUCT_ID"
4  data-ekoo-locale="fr"
5></ekoo-widget>
6
7<script src="https://app.ekoo.co/widgets/widget-4.0.0-standalone.js"</script>

⚠️

No published audio, no widget

If no audio is published for the indicated product, the widget will not display. Check in the backoffice that your audio is indeed in published status.

Official Script

Always use the official version of the script:

1<script src="https://app.ekoo.co/widgets/widget-4.0.0-standalone.js"</script>

Where to Start?

Quickstart →

The essentials to integrate the widget in 5 minutes.

Integrations →

Platform guides: HTML, React, Svelte, GTM, Shopify…

Audio Content →

Create, associate and publish your audio capsules.

FAQ →

Answers to the most common questions.

Legacy & migration →

Migrate from an older version of the widget.