Skip to main content
CHAOS
For Jewellers

Embed your Chaos feed

Show live inventory from the dealers you follow on your own website — Shopify, Wix, Squarespace, Webflow, WordPress, or anything custom. Prices are auto-marked-up using your global or per-dealer markup.

Jump to platform guides

Three ways to integrate

Pick the one that matches your skill level.

Easiest
Drop-in widget

Paste two lines of HTML. Renders a styled grid in any site that lets you add custom code.

Code-free
iframe embed

Paste an <iframe>. Works in Wix, Squarespace, Webflow content blocks, and HTML elements.

For developers
JSON API

Hit one endpoint, render the stones however you like. Full control over markup and styling.

Drop-in widget

Paste this anywhere on your page. The script finds the #chaos-feed div and renders your inventory. No build step, no framework required.

<div id="chaos-feed"></div>
<script src="https://chaosgemstones.com/api/public/chaos.js" data-chaos-key="YOUR_API_KEY"></script>

Optional: change the mount point with data-target=".my-class".

Platform guides

Step-by-step for the major website builders.

Shopify

  1. 1.Admin → Online Store → Themes → Edit code.
  2. 2.Open the page or section where you want the feed.
  3. 3.Paste the Drop-in widget snippet.
  4. 4.Save. Refresh the live page.

Currently render-only. A full product-sync app is coming — let us know if you need it.

Wix

  1. 1.Editor → Add → Embed Code → Embed HTML.
  2. 2.Paste the iframe snippet.
  3. 3.Drag the corner to size it. Publish.

Wix sandboxes inline scripts, so the iframe option is more reliable than the widget.

Squarespace

  1. 1.Edit page → Add Block → Code.
  2. 2.Paste either the widget or iframe snippet.
  3. 3.Save and publish.

Webflow

  1. 1.Add an Embed element where you want the feed.
  2. 2.Paste the Drop-in widget snippet.
  3. 3.Publish.

WordPress

  1. 1.Edit page → add a Custom HTML block.
  2. 2.Paste the Drop-in widget snippet.
  3. 3.Update.

On classic editor, switch to Text mode before pasting.

Custom site

  1. 1.Use the JSON feed for full control.
  2. 2.Or paste the widget — it works in any HTML.
  3. 3.Set caching to whatever matches your traffic.

Notes

  • • Replace YOUR_API_KEY with the key from your API dashboard.
  • • Prices in the response are wholesale × markup. Set your global markup or per-dealer override on the Markup page.
  • • Stones marked sold or reserved are removed automatically.
  • • The feed is rate-limited and cached for 5 minutes at the edge.
  • • Treat your API key like a password. Rotate it from the API dashboard if it's exposed.
  • • Are you a dealer? See the Dealer Write API for programmatic inventory management.