Skip to main content

FAQ editor + embed widget

Clione lets you add FAQs per product, per category, per page, or globally — then injects them into your storefront with one script tag.

Adding FAQs manually​

Under FAQs → Add:

  1. Pick the Entity Type (Product, Variant, Category, Page, or 🌐 Global)
  2. Search for the entity by name (the input shows the name, not the raw ID)
  3. Write the question and answer
  4. Save

Global FAQs apply to every page on your store — perfect for shipping, returns, warranty, size guides. They appear alongside entity-specific FAQs on every render.

Generating FAQs automatically​

Under FAQs → Generate, the system drafts questions+answers using the LLM with your product data as context. Review and approve.

Bulk import​

Under FAQs → Import, paste or upload a CSV:

entityType,entityId,question,answer,locale,sortOrder
product,SKU-001,What is the warranty?,2-year manufacturer warranty,en,0
global,,What are your shipping times?,2–5 business days within the EU,en,0

Exporting​

  • Per-entity: in the Browse panel, filter by entity and click ↓ Export CSV
  • Whole store: click ↓ Download all FAQs (CSV) at the top of the FAQ page → one file with every FAQ across all entities

Embedding on your storefront​

Under FAQs → Embed Script:

  1. Generate an API key
  2. Set the Allowed Domains whitelist (e.g. shop.example.com, *.example.com) — required to block scraping / abuse
  3. Copy the auto-detect snippet:
<div id="clione-faq"></div>
<script
  src="https://api.clione.ai/embed.js"
  data-api-key="sk_live_…"
  data-target="#clione-faq"
  async
></script>

The loader detects the current entity from:

  1. data-entity-type + data-entity-id attributes you put on the script tag (if you want to override)
  2. OpenGraph meta tags (og:type="product", product:retailer_item_id)
  3. URL patterns: Shopify /products/, BigCommerce /product/, WooCommerce body class, etc.

It then fetches the matching FAQs (merging entity-specific + global) and injects both a visible accordion and a JSON-LD FAQPage schema for SEO.