Troubleshooting apps
Troubleshooting common issues with apps.
Use this page to diagnose and resolve common issues when building and running apps.
Why can't I publish my app?
A function has not been approved. Navigate to the Data tab, and review any unapproved functions.
Why doesn't my published app show my latest changes?
Your app might have a tagged release, which tags a particular published version of your app. End users only see the tagged release, and new versions created after the tagged release are published, but not shown to the user.
To update your app so that users always see the most recently published version, complete the following steps:
- Click to open the Change History pane.
- Switch to the Publish history tab.
- In the footer, in response to Which tag should be pinned for publishing?, choose Always publish latest changes.
Learn more in the Publishing guide.
Why do my changes disappear when I change branches?
Each branch is an isolated set of changes that is tied to an app preview. Each new branch opens a new building session. This means that when you begin a new branch, the app preview canvas resets to the latest published version of the app, and the Chat tab has a fresh context window.
To continue building on the same app preview, but in a new conversation, create a new thread by clicking to the left of the prompting box.
How do I get access to the AI provider configured for my organization?
If you receive a message that says You don't have access to the AI provider configured for your organization. Ask an administrator to grant you access or to configure one you can use, reach out to your administrator and direct them to the configuration instructions.
Why can't I access the app builder in my space?
Spaces function as isolated organizations, each with its own subdomain, user accounts, permissions, and settings. As a result, you must enable and configure the app builder on each space.
Why is my app slow?
A variety of factors can contribute to your app running more slowly than expected. Refer to the performance troubleshooting guide for diagnostic and resolution steps.
Why does my function fail after I switch resource environments?
The function uses a resource that isn't configured for the selected environment. The error names the resource and the environment. To resolve it, ask an admin to configure the resource for that environment, or switch to an environment where the resource is configured.
Why am I asked to reauthenticate a resource after switching environments?
Resources that use OAuth authenticate separately in each environment. Sign in again the first time you use the resource in a different environment.
Why does my published app only show production data?
Published apps run in production unless the app URL includes the _environment URL query parameter. Add ?_environment=environmentName to the URL, replacing environmentName with the name of your environment. Alternatively, you can ask the agent to create a user interface element that controls the environment with the useEnvironment hook. Learn more in Choose the environment for a published app.
Why do I get an access error in only one environment?
Resource permissions are granted for each environment. Ask an admin to grant you access to the resource in that environment. Learn more in Resource permissions.