Integrations / HTML

How to add a reviews widget to HTML

Any website that lets you edit HTML can show the badge: static sites, site builders with an HTML block, custom apps.

Claim my free page

Step by step

  1. Claim your free Fiducia page. Open the owner area, enter your domain and confirm with the link we send to an email address on that domain. Your public review page, badge and widget are free.
  2. Copy the code. Replace yourshop.com with your domain. The badge shows your rating and links to your review page; the widget shows your latest reviews as a carousel, list or grid.
    Badge (with review structured data):
    <script src="https://fiducia.lumnika.com/widget/fiducia-badge.js" data-domain="yourshop.com" data-schema="1" async></script>
    Reviews widget:
    <script src="https://fiducia.lumnika.com/widget/fiducia-reviews.js" data-domain="yourshop.com" data-layout="carousel" async></script>
    Both load asynchronously, use no cookies and are isolated from your site's CSS. Options (layout, language, theme, number of reviews): see the live demo
  3. Paste it in HTML. Paste the snippet in your HTML where the badge should appear, for example in the footer or next to your Add to cart button. It renders in place of the script tag.
  4. Turn on review rich snippets. Keep data-schema="1" on the badge: it adds Organization JSON-LD to the page head. Star ratings in Google come from the product widget on your product pages.
  5. Collect reviews automatically. Call the invites API from your server after each order or delivery (see below).

Automatic invites from your backend

Call the invites API from your server when an order is paid or delivered. The key must stay on the server: never put it in page code.

Any other tool (Zapier, Make, n8n or your own backend) can send an invite with one HTTP request to the invites API. Create the API key in your dashboard (Pro):

curl -X POST https://fiducia.lumnika.com/api/v1/invites \
  -H "Authorization: Bearer fk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email":"customer@example.com","name":"Maria","orderRef":"1042"}'

The response is 202 with the invite link. Sending the same orderRef again returns 409 and no second email, so retries are safe. Limit: 500 invites per 24 hours.

Questions

Will the widget slow down my HTML site?

No. The script is small, loads asynchronously after your page, has no dependencies and sets no cookies. If the review service is unreachable the badge simply does not appear.

Will Google show review stars for my site?

Google does not show star snippets for reviews a business publishes about itself on its own site (self-serving reviews of LocalBusiness and Organization). The structured data is still read by other search engines and by AI assistants such as ChatGPT, Perplexity and Gemini, and your public Fiducia page is a separate site where your rating can appear.

Which HTML plan do I need?

No requirements: any page that can load an external script.

Is it free?

Yes: the public page, the badge, the widget with your latest reviews and manual invites are free. Pro (€19/$19 a month, 14-day free trial) adds automatic invites (Stripe, API, plugins), bulk CSV invites, up to 50 reviews in the widget and no branding.

Your review page is waiting

Claim it in two minutes, then paste one line of code on your site.

Claim my free page

Other platforms: Wix · Squarespace · Webflow · BigCommerce · Framer · Ghost · WordPress · WooCommerce · Shopify

Menus and plan requirements for HTML checked against the official documentation on 1 October 2026: developer.mozilla.org