Trust and reference

Troubleshooting and support

Common issues, how to unblock yourself, and how to reach us.

Most bumps have a quick fix, and most of the quick fixes are on this page. Find your symptom in the section it belongs to, or open search with Ctrl+K (Cmd+K on a Mac) and type a keyword from it.

First 90 seconds

Before anything else, three checks resolve a surprising share of problems:

  1. Is the change published? You and your visitors look at different copies of the app. If the live site is missing something, hit Publish. See Preview vs published.
  2. Did auto-fix already handle it? A brief loading cover over the preview means a repair is running. Give it a moment before acting.
  3. Reload once. The preview and panels are live views; a plain reload clears a stale one.

Is it you, your network, or Vaulter?

When something fails with no useful message, sort out whose problem it is before debugging your app:

  • Try a private browser window. If the problem vanishes there, a browser extension or stale cached state was the culprit; clear the site's data or disable extensions for it.
  • Try another network or your phone's hotspot. Office and school networks sometimes block the connections live previews use.
  • Try another of your projects. One broken project points at that project (tell the agent, or roll back); everything failing at once points at the platform or your network.
  • If it looks like the platform, it is usually brief; try again in a few minutes, and tell support what you saw if it persists, including the time it happened.

Building and the agent

The agent did not do what I wanted

Normal, and usually a one-line fix. Tell the agent specifically what is off, and attach a screenshot; it fixes what it can see far more reliably than what it has to guess at. Short, specific feedback beats re-explaining everything. See the prompting guide.

The agent changed things I did not ask it to touch

Point it out concretely: "you also changed the header color, put it back". For the whole change, the Undo button on the agent's message restores every touched file at no token cost. To prevent it, scope your requests: "on the Contact page only, ..." keeps edits contained.

The agent says it made a change but I do not see it

First check you are looking at the right place: the preview tab (not the published site), and the right page inside the app. Then give the rebuild a few seconds. If it is genuinely absent, say so: "I do not see the new button on the Services page", and the agent will re-check its own work.

My message failed to send, or the agent seems stuck

One project runs one AI change at a time. If a change is still in flight (including an automatic repair), a new message can be refused until it finishes. Wait for the working indicator to settle and send again. If a turn has been spinning for many minutes, reload the page; an interrupted turn releases its lock shortly.

I get "Unsupported file type" when attaching a file

The composer accepts images and common document types, up to 4 attachments per message and 8 MB each. Convert exotic formats (a HEIC photo, for instance) to PNG or JPG and re-attach.

The agent invented a feature Vaulter does not have

If the agent describes platform behavior that contradicts these docs, trust the docs and rephrase your request around what actually exists. See Known limitations for the honest map.

Plan mode is locked

Plan mode is a paid feature. On the free plan it shows with a lock; upgrading to Starter or above unlocks it. See Plans and pricing.

A change made everything worse and I want out

Three exits, in escalating order: Undo on the agent's last message, asking the agent to revert in your own words, or rolling back the live app to a previous published version. All three are covered in one page.

Preview problems

"Preview failed to build" with a Retry button

Vaulter repairs most build problems automatically behind the loading cover; this message means the automatic attempts ran out. Try Retry first. If it persists, tell the agent what you were doing when it broke; it can read the build logs directly. See Auto-fix and build repair.

The preview is a blank white screen

A blank render triggers its own automatic repair once per build, so wait a moment first. If it stays blank, reload the preview, then tell the agent "the preview renders a blank screen" and mention the last change you made.

The preview keeps showing an old version of my app

The preview rebuilds after every change but the browser can hold a stale frame. Reload the preview panel. If reloading does not help, make any small change (or ask the agent to rebuild) to force a fresh build.

The preview works, but a specific flow errors when I click through it

Runtime errors in the preview are caught and sent to the agent as targeted fix requests automatically, with attempts spaced out so they never spiral. If the error keeps returning after a repair, describe the exact click path that triggers it; the reproduction is the diagnosis.

The preview asks me to sign in

Apps with sign-in enabled show their real auth in the preview too. Create a test account, or sign in with one you made earlier; testing as a real user is the point. Two test accounts is the recommended setup for verifying data privacy.

Images or uploads work in the preview but the file itself will not upload

Uploads are capped by plan: 10 MB on Free, 50 MB on Starter, 100 MB on Pro and Teams. Oversized files are refused. If a common file type (a CSV, for instance) is refused as unsupported, tell the agent; the allowed types are configurable per app.

Publishing and the live app

My change did not show up on the live site

The change is in your preview but not published. Visitors see the last published version, always. Hit Publish. The one exception: auth settings (providers, who can sign in) reach the live app immediately without a republish.

"This workspace has reached its limit of N publishes per day"

Publishing is counted per workspace over a rolling 24 hours: 10 per day on Free, 50 on Starter, 200 on Pro, unlimited on Teams. Wait for the window to roll, or upgrade. Failed builds and rollbacks do not count against the limit.

The publish failed

Publishing validates your app before it ships, and refuses rather than shipping something broken; the message says which check refused. A failing database migration is the most common blocker (see the Data section below). Fix the named problem, then publish again; the failed attempt did not consume your daily count.

The live app shows an error my preview does not

Almost always a version gap: the live app is an older publish. Publish your current state. If the error is genuinely live-only, roll back to the last good version first (Vault → Deployments), then debug in the preview without your users watching.

My published app is not showing up on Google

On the free plan, published apps are deliberately kept out of search engines. On paid plans, indexing is on and Google auto-indexing submits your sitemap for you, but Google itself can take days, especially for a brand-new domain.

I want to take my app offline

The cleanest lever is require sign-in to view: the app stays published, but nobody outside your invite list can see anything, effective immediately. Deleting the project takes the app down entirely. If you need an app fully unpublished but the project kept, contact support.

Sign-in and users, in your app

Someone cannot sign up for my app

Check your access setting in Vault → Auth: with "Only people on your list", anyone not invited is turned away with "You do not have access to this app yet. Ask whoever runs it to send you an invite." Add them to the list, or switch registration to open. Also check the App Users list: a suspended user stays suspended.

A user sees "Your access to this app is not active"

That user's account has been suspended or removed in your App Users list. Restore them there and they can sign in again immediately.

A user sees "This app has reached its member limit"

Your app is at its plan's user cap (20 signed-in users on Free). Remove unused accounts, or upgrade the plan to lift the cap.

"This app requires sign-in, but sign-in is temporarily unavailable"

A temporary platform-side condition on walled apps. It typically clears on its own within moments; if a user reports it persisting, contact support with your project ID.

Sign-in works in the preview but not on the published app

Auth setting changes apply live immediately, but a new sign-in page or auth-dependent code in the app itself waits for the next publish. Publish, then test the live flow in a private browser window.

Two users can see each other's data

A privacy-class question, and worth fixing before anything else: the table is shared (or public) when it should be private per user. Tell the agent precisely who should see what, and verify with two test accounts. See How data privacy works.

Data and database

A migration failed and the Database panel shows a banner

Transient failures retry and heal on their own. If a migration is still failing after its retries, the Migrations section shows the exact migration and a plain-language reason. Ask the agent to fix that migration. Publishing is blocked until the schema is healthy again, deliberately, so a broken schema never ships.

Data I added in the preview is missing, or test data is showing

The preview and the published app share your app's database, so real rows appear in the preview and test rows you create while building are real too. Delete test rows from the Database panel before launch, or ask the agent to clear a table.

A user cannot see data they should see

The mirror image of the privacy problem above: the table is private per user when it should be shared. Same fix, in the other direction; tell the agent who should see what.

I deleted data by accident

Check whether the app has a delete-confirmation or archive pattern first (ask the agent). Vaulter does not keep automatic row-level backups you can restore from, so treat the Database panel's delete actions as permanent. For bulk safety before an experiment, ask the agent to copy the table.

The agent added a table or column I do not want

Schema changes are code changes: ask the agent to remove it, or Undo the change that added it. A column that is dropped disappears with its data, so say if anything in it must be kept.

Domains

My custom domain will not connect

DNS changes take minutes to hours to propagate, and the Domains panel keeps checking automatically. If it is stuck well past that, re-check each record's exact name and value against what the panel shows, and delete old conflicting records on the same name. The DNS reference lists the usual culprits.

The domain connects but shows a security warning

SSL certificates are issued automatically once DNS points correctly, and issuance can lag connection by a few minutes. If the warning persists past half an hour, disconnect and reconnect the domain in the Domains panel to restart issuance.

www works but the bare domain does not (or the reverse)

Each form needs its own DNS record. Check the panel's record list covers both, and that both records exist at your DNS provider exactly as shown.

I bought a domain in Vaulter and it is not live yet

Purchased domains connect automatically, including DNS, but registration itself can take a little while to complete at the registry. Check the Domains panel for status; no action is needed from you.

My old domain still loads the app after I disconnected it

DNS caching: visitors' networks remember the old records for up to a day. It expires on its own. To force the point sooner, also remove the records at your DNS provider.

Connectors

A connector call fails with a permissions or scope error

Reconnect the service in the connector panel; an expired or revoked authorization is the usual cause. If the failure names a missing permission, the reconnect flow will request it.

A connector suddenly stopped working

Check the service's own status first (Stripe, Slack, and the rest have status pages), then reconnect. If the connector was working and nothing changed on your side, a reconnect refreshes credentials and resolves most cases.

"Too many requests" from a connector

Connector calls are rate limited per app to protect both sides (60 calls per minute). A burst of retries in your app's code is the usual trigger; the limit clears within the minute. If you set an owner spend quota on a connector and it is exhausted, calls stop with a payment-required error until the 30-day window moves or you raise the quota.

The service I need is not in the catalog

The catalog covers 27 services, and the Custom API connector reaches any other HTTP service with an API key. Describe the service and what you want to do with it, and the agent wires it through Custom API.

Tokens, billing, and limits

"Daily token limit reached"

The daily limit spreads your monthly pool across the period (20 percent of your monthly allowance per day on Starter and Pro, 300,000 tokens on Free). Nothing is lost; building with AI resumes the next day. Top-up tokens are exempt from the daily limit, so a top-up unblocks you immediately.

I ran out of monthly tokens

The pool resets on your billing date. Until then: buy a top-up (never expires, spent after the monthly pool), move up your plan's token ladder, or keep working token-free (editing code by hand, Edit Mode style changes, and everything non-AI stays available).

Tokens are draining faster than I expected

Check the model: Vaulter Max spends fastest, Mini slowest. Check the habit: vague requests cost multiple attempts, and one precise request is the cheapest. And remember that automatic repairs are never billed, so auto-fix is not the culprit.

I upgraded but the new allowance is not showing

Plan changes apply to your workspace, and the Tokens panel (Settings → Tokens) reads live from it. Reload once; if the panel still shows the old plan after a successful payment, contact support with your workspace name.

A team member is burning the shared pool

Teams workspaces have per member budgets and a circuit breaker that stops any single member from spending more than a share of the remaining pool in a few hours. Set a monthly budget for that member in workspace settings, and review per member usage in the workspace analytics.

Platform sign-in (vaulter.run itself)

My 6-digit login code never arrives

Codes come from noreply@vaulter.run; check spam and promotions folders. Codes expire after 10 minutes, and requesting a new one invalidates the old, so use the newest email.

I signed up with Google but tried to log in with email (or the reverse)

Both routes lead to the same account when the email address matches. Use whichever is convenient; there is no password to remember either way.

Getting help

Still stuck? Reach out to support from your account, and include:

  • What you were trying to do.
  • What happened instead, with the exact message if there is one.
  • The project ID (copy it from the project's detail page menu).

The more specific you are, the faster we can help. Security-related reports are prioritized; say so in the subject.

Was this page helpful?