Setup & Integration Guide

Getting Started

Quickstart

Embed ORA on your site in three steps.

No programming experience required. Copy your key, paste one script tag, and connect your site.

Get your widget key

Paste the embed script

Add the one-line script right before the closing </body> tag of your theme or page template.

Connect your catalog and go live

In the dashboard, connect your Shopify store or upload a CSV catalog. The widget will appear on your site immediately.

index.html

<!-- Paste before the closing </body> tag -->
<script
  src="https://tryora.live/widget/ora-widget.js"
  data-ora-key="biz_live_your_publishable_key"
  data-ora-api="https://api.tryora.live"
  data-ora-position="bottom-right"
  defer>
</script>

Getting Started

Platform embed snippets

Ready-to-paste code for HTML, Shopify, Next.js, Vue, Webflow, and Wix.

Pick your platform and paste the snippet exactly as shown. Replace biz_live_your_publishable_key with your actual key.

index.html

<script
  src="https://tryora.live/widget/ora-widget.js"
  data-ora-key="biz_live_your_publishable_key"
  data-ora-api="https://api.tryora.live"
  data-ora-position="bottom-right"
  defer>
</script>

Platforms

Shopify

Install the ORA Shopify App in under 60 seconds with zero code editing.

Method A — ORA Shopify App (Recommended & Zero Code)

You do not need to touch any code or edit theme.liquid. Simply install the official ORA app and enable the native Theme App Embed:

Install the ORA Voice AI app from the Shopify App Store or connect your site in the ORA dashboard under Agent Configuration → Sync Catalog.
In Shopify Admin, navigate to Online Store → Themes and click Customize.
In the left sidebar, click the App embeds icon (or click “Enable in Theme” in the ORA Shopify app).
Toggle the ORA Voice Widget switch to ON.
Click Save in the top-right corner. The voice agent and live product catalog sync are instantly active!

Zero Code: The Shopify App automatically provisions your publishable widget key and syncs your products, inventory, and variants. No theme files are modified.

Method B — Manual Script Embed (Optional)

If you are running a custom or headless theme without App Embeds, you can manually paste the embed snippet:

In Shopify Admin, go to Online Store → Themes → ⋯ Actions → Edit Code.
Open layout/theme.liquid.
Paste your ORA embed script right before the closing </body> tag and click Save.

Platforms

WooCommerce & WordPress

Add ORA via a plugin or by editing your theme template.

Method A — Plugin (recommended)

In WordPress Admin, go to Plugins → Add New.
Search for "WPCode" or "Insert Headers and Footers" and install it.
Go to Code Snippets → Header & Footer.
Paste the ORA script into the Footer box and save.

Method B — Theme file

In your child theme's footer.php, paste the script before <?php wp_footer(); ?> or the closing </body> tag.

Platforms

Webflow, Wix & Framer

Embed ORA into no-code site builders.

Webflow: Project Settings → Custom Code → paste into Footer Code → Save & Publish.
Wix: Settings → Custom Code → Add Custom Code → paste the script, placement: Body — End.
Squarespace: Settings → Advanced → Code Injection → Footer → Save.
Framer: Site Settings → General → Custom Code → End of <body> → Publish.

Widget Settings

Widget attributes

The full list of data attributes you can set on the script tag.

All customization is done via data-* attributes on the script tag — no JavaScript required.

Attribute	Values	Default	Description
`data-ora-key`	`biz_live_xxxx`	Required	Your store's publishable widget key from the dashboard.
`data-ora-api`	API origin URL	Auto-detected	Where the widget connects. Derived from the script origin when omitted.
`data-ora-position`	`bottom-center`, `bottom-right`, `bottom-left`	`bottom-center`	Corner placement of the floating orb.

custom-position.html

<script
  src="https://tryora.live/widget/ora-widget.js"
  data-ora-key="biz_live_your_publishable_key"
  data-ora-api="https://api.tryora.live"
  data-ora-position="bottom-right"
  defer>
</script>

Widget Settings

Supported languages

Languages ORA can understand and respond in.

Language is configured per store from your dashboard under Agent Settings. When a visitor speaks a supported language, ORA responds in that language for the session.

Language	Code	Notes
English (US)	`en-US`	Full support — voice, catalog search
English (UK)	`en-GB`	Full support — voice, catalog search
Bengali (BD)	`bn-BD`	Full support — voice, bilingual queries, bKash

Catalog & Knowledge

Product catalog

How ORA learns your products and stays up to date.

ORA answers product questions based on your catalog. Keep it updated so recommendations are accurate.

Shopify: Connect your store in the dashboard. ORA reads your product catalog, prices, and variants.
CSV upload: For other platforms, upload a product CSV from the dashboard. Changes take effect immediately.
Product variants: ORA understands sizes, colors, and other variant options when they are present in your catalog.

CSV format

Use these column headers when uploading a catalog manually:

products.csv

id,title,description,price,stock,category,tags
KB-01,Obsidian Desk Mat,Water-resistant micro-woven cloth with non-slip base,29.99,150,Accessories,"desk mat, waterproof"
KB-02,Mechanical Keyboard 75%,Hot-swappable switches with Bluetooth and 2.4GHz,119.00,24,Keyboards,"wireless, mechanical"
KB-03,Wireless Precision Mouse,26000 DPI optical sensor with 80-hour battery,69.00,12,Mice,"lightweight, wireless"

Catalog & Knowledge

Policies & FAQs

Teach ORA your shipping rules, return policy, and store details.

You can add store policies directly in the ORA dashboard. Shoppers frequently ask about shipping, returns, and contact details — these answers come from what you write there.

Shipping & delivery

Estimated times, free shipping thresholds, and tracking.

Returns & refunds

Return window, conditions, and refund process.

Store information

Business hours, contact email, and physical address.

ORA stays on-topic. If a visitor asks something unrelated to your store, it redirects the conversation back to your products and policies.

Testing & Launch

Pre-launch checklist

Verify the widget is working before announcing it to customers.

Run through these checks after installing the widget:

Orb placement: The floating orb appears in the correct corner on both desktop and mobile.

Microphone prompt: Clicking the orb requests microphone permission and ORA speaks a greeting.

Product accuracy: Asking "What products do you have?" returns items from your actual catalog.

Testing & Launch

Troubleshooting

Quick fixes for the most common setup issues.

The floating orb isn't appearing.

Make sure you replaced biz_live_your_publishable_key with your actual key from the dashboard. Check the <script> tag is placed before </body>. Try a hard refresh or incognito window.

The microphone isn't turning on.

Browsers require an HTTPS connection to access the microphone. Make sure your site has a valid SSL certificate. If you previously blocked mic access, click the lock icon in your address bar and allow it.

ORA doesn't know about my products.

Check that your store is connected in the dashboard, or that your CSV catalog has been uploaded. Product queries only work after the catalog is synced.

 <script src="https://tryora.live/widget/ora-widget.js" data-ora-key="biz_live_your_publishable_key" data-ora-api="https://api.tryora.live" data-ora-position="bottom-right" defer> </script>

Attribute

Values

Default

Description

data-ora-key

biz_live_xxxx

Required

Your store's publishable widget key from the dashboard.

data-ora-api

API origin URL

Auto-detected

Where the widget connects. Derived from the script origin when omitted.

data-ora-position

bottom-center, bottom-right, bottom-left

bottom-center

Corner placement of the floating orb.

Language

Code

Notes

English (US)

en-US

Full support — voice, catalog search

English (UK)

en-GB

Full support — voice, catalog search

Bengali (BD)

bn-BD

Full support — voice, bilingual queries, bKash

id,title,description,price,stock,category,tags KB-01,Obsidian Desk Mat,Water-resistant micro-woven cloth with non-slip base,29.99,150,Accessories,"desk mat, waterproof" KB-02,Mechanical Keyboard 75%,Hot-swappable switches with Bluetooth and 2.4GHz,119.00,24,Keyboards,"wireless, mechanical" KB-03,Wireless Precision Mouse,26000 DPI optical sensor with 80-hour battery,69.00,12,Mice,"lightweight, wireless"

Set up ORA on your site

Quickstart

Get your widget key

Paste the embed script

Connect your catalog and go live

Platform embed snippets

Shopify

Method A — ORA Shopify App (Recommended & Zero Code)

Method B — Manual Script Embed (Optional)

WooCommerce & WordPress

Method A — Plugin (recommended)

Method B — Theme file

Webflow, Wix & Framer

Widget attributes

Supported languages

Product catalog

CSV format

Policies & FAQs

Shipping & delivery

Returns & refunds

Store information

Pre-launch checklist

Troubleshooting

The floating orb isn't appearing.

The microphone isn't turning on.

ORA doesn't know about my products.

Set up ORA on your site

Quickstart

Get your widget key

Paste the embed script

Connect your catalog and go live

Platform embed snippets

Shopify

Method A — ORA Shopify App (Recommended & Zero Code)

Method B — Manual Script Embed (Optional)

WooCommerce & WordPress

Method A — Plugin (recommended)

Method B — Theme file

Webflow, Wix & Framer

Widget attributes

Supported languages

Product catalog

CSV format

Policies & FAQs

Shipping & delivery

Returns & refunds

Store information

Pre-launch checklist

Troubleshooting

The floating orb isn't appearing.

The microphone isn't turning on.

ORA doesn't know about my products.