Installation
Install Lumen on your Shopify store from the Shopify App Store.
Installing Lumen takes less than 5 minutes. No coding required.
Prerequisites
Before installing, make sure you have:
- An active Shopify store (any plan — Basic, Shopify, Advanced, or Plus)
- Store admin or staff access with Apps permission
- An Online Store sales channel enabled (this is where the chat widget appears)
Step 1: Install from the Shopify App Store
- Visit the Lumen listing on the Shopify App Store.
- Click Add app.
- You'll be redirected to your Shopify admin to review the permissions Lumen needs.
- Click Install app to confirm.
Step 2: Approve permissions
Lumen requests the minimum permissions needed to function:
| Permission | Why it's needed |
|---|---|
| Read orders | To look up order status when customers ask |
| Read fulfillments | To get tracking and shipping information |
Lumen requests the minimum permissions needed — only read access to orders and fulfillment data. It cannot modify orders, customers, or products.
Step 3: Enable the chat widget
After installation, you need to enable the Lumen chat widget in your theme:
- In your Shopify admin, go to Online Store → Themes.
- Click Customize on your active theme.
- Click App embeds in the left sidebar (the puzzle-piece icon).
- Find Lumen Chat Widget and toggle it on.
- Click Save.
The chat widget will now appear on your storefront.
What happens next
Once installed, Lumen immediately has access to your order data. Customers can start asking about their orders right away on the Free plan (50 lookups/month).
To configure the widget appearance, set up escalation emails, or upgrade your plan, continue to the Setup Guide.
Lumen starts working immediately after installation. There's no additional onboarding or setup required for basic order tracking.