Troubleshooting
Start here
The fastest way to fix almost anything, and how to reach us.
Most problems in Lumina come down to one of five things: billing, usage limits, a missing subdomain, a domain that is not allowed or not verified yet, or a permission your teammate does not have. This page gets you to the right fix fast.
The fastest fix: ask Lumina Assistant
Lumina Assistant can see your account. It knows your plan, your usage, your demos, your embeds, and your domains, so it can usually tell you what is wrong in one message.
- Open your dashboard at app.luminasales.io.
- Press ⌘J (Mac) or Ctrl+J (Windows), or click Lumina in the top bar.
- Describe what you see, including any message on screen.
If you work in Claude Code, Codex, Cursor, or Grok Bot, connect the Lumina MCP server and ask there instead. It reads the same account data.
Check these five things first
| Check | Where | What you are looking for |
|---|---|---|
| Your plan is active | Settings → Billing | Status is active. A failed payment pauses every live part of your account. |
| You have usage left | Settings → Usage | No meter says used up. A voice call needs 5 minutes left. |
| You claimed a subdomain | Brand | A subdomain is set. Publishing demos, landers, and embeds all need one. |
| Your domains are live | Brand → Your own domains | Every custom domain says Live, not Waiting on DNS or Failed. |
| You have access | Ask your agency owner | Members only see the sections the owner gave them. |
Is it you or us?
Open the status page. It shows a live check of every part of Lumina: accounts, sign-in, demos, embeds, voice calls, billing, and more.
- Everything says Operational: the problem is most likely a setting in your account. Use the guides below.
- Something says Degraded or Outage: it is on our side. Wait a few minutes and try again. You do not need to change anything.
Find your problem
| What is happening | Read this |
|---|---|
| A demo will not publish, a call will not connect, or the chat does not answer | Demos and voice calls |
| An embed is blank or missing on a website | Embeds |
| A custom domain will not verify, or shows the wrong page | Domains and DNS |
| You or a teammate cannot sign in, or an invite does not work | Signing in and your account |
| A payment failed, or something says paused or used up | Billing and usage |
| A client cannot open their portal, intake form, or sign-in link | Clients, portal and onboarding |
| An API call or MCP connection fails | API and MCP |
| You saw a specific error message | Error message index |
Contact support
If the guides and Lumina Assistant did not fix it, email support@luminasoftware.app. To get an answer on the first reply, include:
- your agency name and subdomain,
- the page you were on (copy the address bar),
- the exact message you saw, or a screenshot,
- what you expected to happen,
- for API and MCP problems, the
request_idfrom the error response.
Never send passwords, access tokens, or API keys by email. If we need access to something, we will ask in a way that keeps it safe.
Still stuck? Ask Lumina Assistant in your dashboard (⌘J on any page), or read how to get help.
