Troubleshooting
Fixes for the problems people most often hit while setting up and building.
Signing in
The browser didn't open, or I closed it
In Rivet, press Open the sign-in page again. Rivet waits 5 minutes for you to finish; after that it says "Signing in took longer than 5 minutes, so Rivet stopped waiting", and you press Sign in with Mapped to start again.
"Rivet could not sign you in"
The page in your browser says why. Most often the sign-in "was not started by this Rivet, was already used, or is older than its limit" (5 minutes for a sign-in, 15 for a sign-up). Close the browser tab, go back to Rivet and sign in again.
If the tab says "You are already signed in", Rivet is signed in: close the tab and go back to Rivet. Pressing Allow twice on Mapped's page asks Rivet twice for the same sign-in, and Rivet answers both with the same page.
"This app reads its data through a Mapped sign-in"
You opened an app built on an org you reach through Log in with Mapped, while you were logged out. Rivet goes back to the home screen. Press Log in with Mapped at the top, log in with the account you built the app with, and open it again from Your apps.
"That app isn't here"
The app belongs to another Mapped account, or it was deleted. Log in with the account you built it with to see it again.
"Check your email"
You made a Mapped account from Rivet, and Mapped won't sign you in until the email address is verified. Mapped sent a verification link to the address Rivet shows; open it, then press Sign in again in Rivet. If no email arrives within a minute, check your spam folder, then press Sign in again: Mapped sends a fresh link (one a minute at most). If Rivet says Mapped could not send a new verification link, wait a minute and try again.
"Rivet could not add you to the Sandbox org yet"
You are signed in; only the seat in Mapped's Sandbox org was not given. Rivet asks Mapped for it right after every sign-in, and the sentence after this one says what Mapped answered. Press Try again under your name in Settings › Mapped login (or on your sign-in's row in Settings › Personal access tokens). If it keeps failing, log in with Mapped again, and if that doesn't help, tell whoever looks after Mapped at your company what the sentence says.
I don't see my company's org
Your Mapped login opens the orgs your account belongs to. If one is missing, ask your Mapped administrator to add you, or add a personal access token for it.
Claude
Claude Code was not found
Rivet couldn't find Claude Code on your computer ("Claude Code was not found on PATH or in the usual install folders").
- Press Install Claude Code on the card. Rivet installs it and the card moves on to signing in (Set up Claude Code).
- If you installed it yourself in a terminal, open a new terminal and type
claude --version. If it prints a version, go back to Rivet and press Check again.
Having the Claude app is not enough: it is a different program from Claude Code.
The install stopped
The card says "The installer stopped" with what the installer printed last. Most often the computer couldn't reach claude.ai: check your internet connection (or ask whether your company's network blocks it) and press Try again. You can also install it yourself under Or do it yourself in Terminal.
Claude Code is installed but not signed in
Press Sign in to Claude on the card, sign in with your Claude account in the browser that opens, and paste the code Claude shows into Code from Claude. Then press Test in Rivet.
If the card says Claude Code is installed, but Rivet could not tell whether it is signed in, Claude Code didn't answer Rivet's question in time, or is too old to. Press Sign in to Claude anyway, or Check again.
If the card says "The sign-in did not finish", it also says what Claude Code reported. Press Try again and copy the
whole code: it is long. Or open a terminal, type claude auth login, and sign in there.
"The Anthropic API key was rejected (401)"
The key was mistyped, or it was deleted in the Claude Console. Paste it again in Settings › Who builds, or create a new one.
A build stops at a usage or rate limit
With Claude Code, you've reached your plan's limit for now, and building stops until the limit resets. With an API key, "Rate limited by the Anthropic API (429)" means wait a minute and try again, and a message ending "(402)" means the account's billing needs attention in the Claude Console. To build another way meanwhile, switch in Settings › Who builds.
Building
Build it stays grey
Build it is under Describe it, and needs words in the description box. If you don't see it, check that a site is chosen (when an org has more than one, you have to pick it), then a template, then Describe it.
A template is greyed out
The site can't carry it, and the reason is under its name. No floor plans at this site means Rivet found no plan on the site's floors or on its rooms, and Plan Centric starts with one. Choose another template, or another site.
"Approximate counts" or a dash on the site card
Mapped couldn't count the site in one go, so Rivet counted what it could read. A dash, or Not counted for this site., means Rivet couldn't count that part; it never means there are none, and nothing is greyed out because of it. See What the site card shows.
"Rivet couldn't read this site."
Rivet couldn't reach the site's data when it looked. You can still choose any template and build. If it keeps happening, check your Mapped access in Settings › Access tokens.
"This org has no sites"
The org has nothing in it yet. Choose another org, or ask your Mapped administrator.
A tile shows no data, or "no reading"
Not every piece of equipment reports every reading. Click the tile's i to see what it reads, then ask Rivet: "The Robots to charge tile shows no reading for the Elios quadcopter; leave it out."
When the line under a tile's title says "0 points on" a floor, the tile follows the floor menu and what it reads is on other floors: choose one of them. Readings with no floor at all are read across the site instead, and the tile says so (Tiles and the floor menu).
When every tile is empty, check the Site menu under the app's name: the app may be showing another site than the one you meant, or a page may open on a site of its own. Pick the right one, or tell Rivet which site to use (Switch the site). If a shared copy opens on the wrong site, change where the app opens (Where the app opens).
"Nothing of this kind on this site"
The site has none of what the tile asks for, and the tile says what: "This site has no things of type Air_Handling_Unit.", or "This site has no points of type Supply_Air_Temperature_Sensor." Nothing failed, so the tile has no mark in its corner and the header doesn't count it among the cards having trouble (What the marks mean). If the app was built for another site, choose it in the Site menu; otherwise ask Rivet for something this site measures, or to take the tile off the board.
"Only the first … were checked, so this card may leave some out"
A tile that keeps only certain kinds of equipment (the electric meters, say) asks the site for that kind and looks through all of it, however much other equipment the site has. Only a site with more than 10,000 pieces of one kind is cut, and the tile then says "Only the first 10,000 were checked, so this card may leave some out." A tile that reads a long list says, for example, "Only the first 1,000 of 4,169 rows were read, so this card may leave some out." What it shows is right as far as it goes. To be sure of every one, ask Rivet to name the equipment the tile should show.
A tile that counts service requests and work orders reads up to 5,000 of them, open ones first and then the newest, so a store's whole list is usually read. A site with more says what was read, for example "All 22 open records were read, and closed ones were read back to Aug 23, 2025 only, so a count of closed ones from before then may be low." A count of open ones is then complete; a count of closed ones is complete for anything newer than that date.
Readings look old
Some sensors report only when a value changes, so a steady reading can be hours old and still right. Hover a number to see when it was read, or turn its tile over with i; a number shows its age on its face only when the reading is older than the time range the page shows. If everything is old, look at the app's header: ● Live or ○ Live off means readings are arriving (with live off, every few seconds). Reviewing or Held means the page stands at an earlier moment: press it to come back to now. For anything else, see In an open app.
"This source can't show the past"
A plan you have taken back in time asks its source where things were at that moment, and what its readings were, and some sources only know where things are now, or keep readings for a short while. The plan says so rather than draw today's positions as if they were then, or show rooms as unmeasured. Press Live to return, or look at a source that keeps history.
"Couldn't read where things were at this instant"
The read for that moment failed, so the plan shows no positions for it rather than guess. Move the slider a little to ask again, or press Live. "Reading where things were…" means the read is still under way.
"Couldn't read the readings at this instant"
On a plan that colours its rooms by a reading, such as temperature, the read of the readings for that moment failed, so no room is coloured or marked as unmeasured for it. Move the slider a little to ask again, or press Live. The same failure while the plan is live leaves its rooms uncoloured and lists "The readings for this map could not be read" under the app's warnings; it is read again on its own.
A word I changed with Edit text went back
Edit text saves a change when you press Enter or click somewhere else in Rivet. If you were still typing and switched to another program, the change was not saved, and Rivet does not say so. Click the words again, retype them and press Enter.
An embedded page "does not let an app show its pages"
The site states which pages may show it, and an app's protected frame can never be one of them. Rivet does not offer to approve such a site, since approving it would change nothing. Put a link to the page in a note instead, or press Open in new tab. See Why some sites refuse to be embedded.
A wall screen says "Rivet can't reach its server"
The screen has had no answer from Rivet's server, or only server errors, for 30 seconds, and the values shown are from the time it names. Check that the computer running the app is on and connected; the banner goes once the server answers again.
Rivet built something different from what I asked
Ask for the change in plain words, or use Inspect to point at the tile you mean. To go back to an earlier version, open Versions and step back.