Errors
Both components report errors toonError as { code, message }. The API
returns the same codes in its error bodies.
Codes the components report on their own:
Codes from Rollout:
The
message explains the refusal in words, for your logs.
When Rollout refuses a token with a 401, the component calls getToken once
for a fresh one and retries. A second refusal is reported rather than retried.
A page whose origin isn’t listed under Pages that may show the apps gets no
error: the browser refuses to load the Rollout frame, and logs a
frame-ancestors violation in its console.
Troubleshooting
- Nothing shows on the record. Check that the app is approved, that the user
(or their org) turned it on, and that
onAppsLoadedlists it. If it’s listed but not shown, the app’s page isn’t answering Rollout’s handshake: ask its publisher. - An app turned on for the org doesn’t show. The render token needs the
same
embed.orgas the token that turned it on. - The frame is refused in the console. Add the page’s exact origin under Pages that may show the apps.
- Apps receive no name or stage for the person. The token’s
embed.person.idhas to equal therecord.idyou render. Mint the token for the recordgetTokenis given. - The org switch doesn’t appear. The marketplace has to allow For their
org, and the token needs
embed:enable_organdembed.org.