Troubleshooting
Clients, portal and onboarding
Portal links, sign-in emails, intake forms, and vault requests.
Fixes for problems your clients hit with their portal, sign-in emails, and onboarding forms, and the ones you hit managing them. For how the portal works, see Client portal.
Your client cannot open their portal link
Portal links look like portal.luminasales.io/p/..., or use your own portal domain if you set one up.
| What they see | Cause | Fix |
|---|---|---|
| That link has stopped working. | You pressed Replace link, turned their portal off, or marked them Churned. | Copy the current link from the client page with Copy portal link and send it again. |
| This page isn't available right now. | Your account is suspended or paused. | Fix billing. See Billing and usage. |
| Your link has expired. Ask for a new one. | Their portal session ended. | Send the current portal link, or tell them to sign in by email. |
Check the switch on the client page says Portal is on. When it is off, their link stops working, but nothing is deleted.
The sign-in email never arrives
The client types their email on the sign-in page and gets a one-time link that expires in 20 minutes. The page always gives the same answer, whether or not the email matches, so it cannot be used to guess who your clients are. That also means a wrong address fails silently.
- Check the email on the client's Profile matches the one they are typing, exactly.
- Check their portal is on.
- Ask them to check spam and promotions. The email comes from your agency name at
portal@luminasales.io, with replies going to your support email. - Wait a minute before asking again. A new link can only be sent once a minute.
| Message they see | Fix |
|---|---|
| This sign-in link has expired | Links work once, for 20 minutes. Request a new one and use it straight away. |
| Too many attempts from here. Wait a few minutes and try again. | Wait a few minutes. |
| That does not look like an email address. | Check for typos. |
After clicking the link and pressing Continue to your portal, they stay signed in for 30 days on that browser.
The onboarding form link does not work
| What they see | Cause | Fix |
|---|---|---|
| This link is no longer valid | You pressed Replace link on the intake card. Their answers are kept. | Copy the new link with Copy intake link. |
| This form has already been completed. | They already pressed Send. | Nothing to do. Read their answers with View answers. |
| Name is needed before you can send this. | A required question is empty. | They fill it in, then send. |
When their portal is on, the intake link signs them into the portal and opens Onboarding. When it is off, it opens the form on its own.
The onboarding designer
| What you see | Cause | Fix |
|---|---|---|
| The create button is greyed out and says "Wait for Lumina to finish" | Lumina is still writing the draft. | Wait, or stop it, then press the button. |
| You can view this draft. Creating the form needs manage access; ask the owner. | A client's form needs Clients manage access. A template needs Onboarding manage access. | The owner grants it on Team. |
| That blueprint is not valid. | Lumina wrote something the form cannot hold, such as a choice question with fewer than two choices, or more than 80 questions. The reason follows. | Ask Lumina to fix that part, or edit the draft by hand. |
| Lumina AI is not on for this workspace | The designer has no AI here. | Edit the quick draft by hand and create the form. |
| Lumina has used its 50 messages for this month. It resets on the 1st. You can still edit the draft by hand. | Your Lumina AI credits are used up. | Edit the draft by hand, or the owner buys more on Usage. |
| A standard question is missing from the form | The design left it out. It is under Not asked, switched off. | Open the form in the editor and switch it on. |
| An access ask did not appear on the client's Access page | They were already asked for it under a similar name, or their page already holds 40 items. | Check their Access page. Remove old items if it is full. |
See Design onboarding with AI.
File uploads fail on the form
| Message | Fix |
|---|---|
| Files need to be under 25 MB. | Compress the file or upload a smaller version. |
| That file came through empty. | Re-save the file and upload it again. |
| Use a PNG, JPEG, WebP, GIF, or HEIC photo. | Photo questions take image files only. |
| Use a PDF, Word document, text file, PNG, or JPEG. | File questions take those types only. |
| That upload did not go through. Try again. | A connection problem. Try again. |
Each question takes up to 20 files. Save and finish later keeps their progress.
Support requests and revisions
| Message they see | Cause | Fix |
|---|---|---|
| Revisions are not open on this build right now. | The build is not in the Revisions stage. | Move the client to Revisions on the client page when you want their list. |
| Be more specific. A one-line note is not enough to revise from. | The list is under 20 characters. | They add detail. |
| This is a preview. Support requests are sent by your client. | You used Open as them. Previews cannot send anything. | Nothing: this is expected. |
You reply to support requests the way you normally talk to the client (email or phone). Set the status with Working on it and Resolved so they see where it stands.
Access vault problems
| Message | Who | Fix |
|---|---|---|
| They have not handed this over yet. | You | Wait for the client, or remind them it is under Access in their portal. |
| This one cannot be opened. Ask them to hand it over again. | You | Ask the client to replace it. |
| Could not record that you opened this, so it stays closed. Try again. | You | Try again. Every opening has to be logged. |
| That is the most this page can hold. | Either | Each client holds up to 40 items. Remove ones you no longer need. |
| Your session has ended. Sign in again to continue. | Client | Sign in again. |
Clients cannot see a secret again after saving it. That is deliberate. If they made a mistake, they press Replace and encrypt and enter it again.
If your client says they finished the form but you are still waiting on logins: logins and keys are never asked in the form. The Onboarding section of their portal shows "N logins or keys are waiting on you" with a link to Access. Point them there.
Errors you see on the client page
| Message | Fix |
|---|---|
| You already have a client with that email. | Open the existing client instead, or use a different email. |
| Paste the full link, starting with https:// | Include https:// in website and link fields. |
| Keep it under 10 MB. | Links and documents take files up to 10 MB. |
| Type the name exactly to confirm. | Deleting a client needs the business name typed exactly. |
| This client still has live billing. | Tick the box to cancel their Lumina billing, or cancel the build first. |
| You have sent an intake from this form. Archive it instead of deleting it. | Forms that were sent cannot be deleted. Archive them. |
The portal shows the wrong name, logo, or colors
The portal uses your Brand settings and the business name on the client's Profile. Update them there. The portal never shows Lumina's name.
Still stuck? Ask Lumina Assistant in your dashboard (⌘J on any page), or read how to get help.
