Troubleshooting

Specific symptoms, and what each one usually means.

The preview is blank or will not load#

The application's container may have been stopped. Start application in the application menu, and give it a few seconds.

If it was already running, ask the builder: the preview is blank — have a look at why.

A build failed#

Say continue. That resolves most of them. See When a build fails.

A build seems to be taking forever#

Watch the steps, not the clock. A build that is working keeps narrating itself — new steps keep appearing — and a large first build legitimately takes a while.

If no new step has appeared for several minutes, that build is no longer running. Within a few minutes it says so and the application comes back to you, ready to be started again from the application menu. Nothing it had already written is lost. Say continue to carry on from where it stopped.

The build finished but nothing changed on the preview#

Two possibilities, in order of likelihood.

Your browser is showing a cached copy — reload with the button above the preview.

Or the change was genuinely not made, because the request was read differently from how you meant it. Read the steps back: they say what it did.

Test or live is showing an old version#

Building does not deploy. A build changes the preview only.

Go to Versions and press Put the latest on Test, or Put what is on Test live. Each card tells you whether it is showing your latest work.

The data I entered in test is not in live#

That is the design. Each environment has its own database, so a version being tested cannot write to what the business is running on. See Environments.

My custom domain is not working#

Check both DNS records exist — the one pointing the address here, and the TXT record proving ownership.
Press Verify in Settings › Domain.
Wait. DNS propagation takes minutes to an hour and cannot be hurried.
Try the platform address. If that works, it is DNS; if it does not, the application is not deployed.

Visitors are not being counted#

They are only counted for deployed environments. The preview is not counted, because it is your team looking at it.

If a deployment is serving and the number is still zero after a day, tell us.

Check they are on the list in Settings › Access, and not suspended.
If they are in the workspace but not this application, either grant them this application or turn on one login for every application.
Reset their password. It is generated, shown once, and emailed if the application has email connected.

The shared password is not being asked for#

Check which environment you are on. The password is per environment — turning it on for test does not turn it on for live.

An email is not arriving#

Settings › Integrations — is email connected?
Press the test. It is a real send to an address that discards it, so a pass means the credentials work.
If the test passes and the application's email does not arrive, the problem is in what the application does, not in the connection. Ask the builder to look at it.
Check the recipient's spam folder, and whether your sending domain is verified with the provider.

The tab title is wrong, or a shared link has no picture#

Those are settings, not code: Settings › Appearance. They apply on the next deployment. See Appearance.

An old address stopped working#

Settings › Redirects. Add the old path and where it should now go. Served in front of the application, so it works even while the application does not. See Redirects.

The test copy is appearing in search results#

Settings › Search engines — test is closed by default, so it has been opened. Close it.

Note that this asks crawlers not to index it; it is not access control. If it must not be readable, use Access.

I cannot find a setting#

Ask for it. The conversation reaches everything in Settings, so where do I turn on the shared password and turn on the shared password both work. See Asking for settings.

Still stuck#

Tell us the application's name and roughly when it happened. We can see the whole build, including the parts the interface deliberately does not show.