Miora Documentation

Install the Miora AI jewelry chat widget on your Shopify store in minutes. Customize colors, welcome messages, and languages to match your brand.

Quick Start Have your Customer ID ready from the Miora dashboard. You'll paste it into a simple code snippet in your Shopify theme.

The Embed Code

Copy this code and paste it into your Shopify theme, just before the closing </body> tag:

HTML

<script src="https://cdn.jsdelivr.net/npm/@supabase/supabase-js@2"></script>
<script src="https://widget.miora.chat/embed.js" data-customer-id="YOUR_CUSTOMER_ID_HERE"></script>

Important Make sure both lines are included. The first line loads your custom settings, the second loads the widget. If you only paste the second line, the widget works but won't show your custom colors.

Finding Your Customer ID

Log into your Miora dashboard at dashboard.miora.chat
Go to Settings or Account
Your Customer ID will be displayed (a long string of letters and numbers)
Copy it exactly and replace YOUR_CUSTOMER_ID_HERE in the embed code

Shopify Installation Guide

Choose the method that works best for your technical comfort level.

Method 1: Shopify Theme Customizer (Easiest)

No code editing required. Perfect for non-technical store owners.

Go to your Shopify admin

Log into admin.shopify.com → Click Online Store → Themes

Customize your theme

Find your current theme and click Customize

Add a Custom Liquid section

Navigate to a page where you want the widget (e.g., Home page). Click Add section → Search for Custom Liquid

Paste the embed code

Copy the embed code from above and paste it into the Custom Liquid box. Replace YOUR_CUSTOMER_ID_HERE with your actual Customer ID.

Save and preview

Click Save. Preview your store — you should see the Miora bubble in the bottom right corner.

Method 2: Edit Theme Code (More Control)

If you want the widget on EVERY page automatically, edit your theme code.

Edit theme code

In Themes, click the ... button on your current theme → Edit code

Find theme.liquid

In the left sidebar, find Layout → theme.liquid

Add the embed code

Scroll to the very bottom. Just before </body>, paste the embed code with your Customer ID.

Save

Click Save. The widget will now appear on every page of your store.

Customization

All customization happens through your Miora dashboard. Changes apply instantly — no need to re-install the widget.

What You Can Customize

Setting	Description	Example
Colors	Background, text, accent colors for light and dark modes	#ECEEE9, #CFE3A5
Store Name	Displayed in the widget header	"Diamond Boutique"
Welcome Message	First message customers see when opening the widget	"Hi! I'm your AI jeweler..."
Tooltip	Text shown when hovering over the closed bubble	"Questions about jewelry? Ask me"
Font	Font family for the widget text	Raleway
Theme	Light or dark mode default	light
Language	Default language for the widget interface	English, French, Spanish...

How to Update

Log into dashboard.miora.chat
Go to the Styling tab
Update colors, text, or settings
Click Save
Changes appear instantly on your website — no re-install needed!

Dashboard Setup

Your Miora dashboard is where you manage your widget settings, view analytics, and upgrade your plan.

Dashboard URL

https://dashboard.miora.chat

Dashboard Sections

Styling — Colors, fonts, store name, welcome message
Language — Default language and welcome message
Billing — Plan upgrades, invoices, usage
Analytics — Widget opens, conversations, customer questions

Colors & Branding

Miora supports full color customization for both light and dark modes. Your customers see the colors you choose, not Miora's defaults.

Color Fields

Background Color — Main widget background
Header Text — Store name and button text color
Primary Color — Buttons, links, active elements
Accent Color — AI message borders, highlights
Dark Mode Colors — Separate set for when customer prefers dark mode

Tip Use your brand's existing color palette. The widget inherits your store's look and feel automatically.

Languages

Miora supports 9 languages out of the box. Customers can switch languages in the widget header.

Supported Languages

Language	Code	RTL Support
English	EN	No
Spanish	ES	No
French	FR	No
German	DE	No
Italian	IT	No
Portuguese	PT	No
Arabic	AR	Yes
Turkish	TR	No
Hindi	HI	No

The AI responds in the selected language automatically.

Troubleshooting

Widget doesn't appear

Double-check your Customer ID is correct (copy-paste from dashboard)
Make sure you saved changes in Shopify/your website editor
Clear browser cache and refresh
Check browser console (F12) for errors — look for [Miora] messages

Colors look wrong

Go to dashboard → Styling tab → update colors → Save
Changes apply instantly — refresh your store to see them
If still wrong, make sure you copied both lines of the embed code

Widget shows but chat doesn't work

Check that the widget URL widget.miora.chat is accessible
Try refreshing the page. If it still doesn't work, contact us at [email protected]

Want to remove the widget?

Shopify Customizer: Delete the Custom Liquid section
Theme Code: Remove the two <script> tags from theme.liquid

Frequently Asked Questions

Do I need to re-install when I change colors?

No. Changes in the dashboard apply instantly. Just refresh your store page.

Does it work on mobile?

Yes. The widget is fully responsive and works on all devices.

Is my customer data safe?

Yes. Conversations are processed securely. We don't store or share customer chat history.

What happens if I exceed my conversation limit?

You'll see a message in the dashboard. You can upgrade your plan or purchase add-on conversation packs.

Can customers switch languages?

Yes. There's a language selector in the widget header. The AI responds in their chosen language automatically.