> ## Documentation Index
> Fetch the complete documentation index at: https://docs.illumichat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing the IllumiChat Shopify app

> Install IllumiChat, enable the chat widget via theme app embeds, and manage it from Shopify admin.

## Install

1. Install IllumiChat from the [Shopify App Store](https://apps.shopify.com/illumichat-v2), or connect your store from IllumiChat under **Knowledge Base → Realtime data → Shopify**.

## Turn on the chat widget

IllumiChat adds the widget as a Shopify **theme app embed** — no code changes to your theme.

1. In Shopify admin, go to **Online Store → Themes**.
2. Click **Customize** on your live theme.
3. Open the **App embeds** tab at the bottom of the left sidebar.
4. Toggle on **IllumiChat Widget**.
5. Click **Save**.

(From IllumiChat, the **Enable in theme editor** button takes you straight to this screen.)

> The widget shows for the store connected to the assistant. If you have multiple stores, connect each store to its own assistant.

## Turn off / uninstall

* **Hide the widget:** in the theme editor's **App embeds** tab, toggle **IllumiChat Widget** off and Save.
* **Uninstall the app:** Shopify admin → **Settings → Apps and sales channels → IllumiChat → Uninstall**.

## Troubleshooting

* **Widget not showing:** confirm the app embed is toggled on in the live theme, and that the assistant is enabled in IllumiChat.
* **Changed themes:** re-enable the app embed on the new theme (app embeds are per-theme).