Install a Version in Your Developer Sandbox

Install an app version in your Developer Sandbox so you can test how Procore users will experience your app before promoting it to production.

Overview

These steps cover the Developer Sandbox, which uses the Sandbox Installation Key. To test in a customer’s On-Demand or Monthly Sandbox, install with the Production Installation Key instead. See Procore Sandboxes.

Every app you create in the Developer Portal includes a Developer Sandbox — a Procore company preloaded with sample project data for building and testing. Before you promote a version to production, install it in your Developer Sandbox and run through it exactly as a Procore user would. You’ll need the Sandbox Installation Key for the version you want to test.

For how installation works across sandbox and production environments, see App Installation Overview.

Before You Begin

Only the App Creator is added to the Developer Sandbox by default. To let teammates install or test the app, add them to the sandbox company directory first. See Add a User Account to the Company Directory.

Install the Version

  1. Sign in to your Developer Sandbox company.
  2. Go to Company Tools > Admin > App Management.
  3. Select Install App > Install Custom App.
  4. Paste your Sandbox Installation Key. Copy it from the Sandbox Version card on your app’s App Details & Versions tab.
  5. Select Install, then confirm.

Your version is now installed. Open the app from the tool or module where its components are configured and test each one against the sample project data.

Test a New Version

Each new version gets its own Sandbox Installation Key. Repeat the steps above with the new key to install and test the update in your sandbox before promoting it.

Next Steps

Once the version behaves as expected in your sandbox, promote it to make it available for production use. See App Versioning & Production.

Was this page helpful? Thanks for your feedback!