Create App Configurations in Procore

For Use with Embedded Apps Only

Be aware that creating App Configurations only applies to Embedded Apps. If you do not see a Configurations tab on an App's show page, that indicates that you do not have the Embedded Experience version of that App. Please visit the Procore Marketplace to obtain the embedded version of the App you want to configure.

Background

App configurations allow you to customize how Embedded Apps behave and determine where they can be launched within Procore. Depending on your organization's setup, configurations can be scoped tightly to a single project, deployed globally across all active and future projects, or made available company-wide.

Things to Consider

  • Required User Permissions

    • To Create a Configuration for a Specific Project:

      • User must be a valid contact in the Procore Directory tool.

    • To Create a Configuration from the Company Admin tool:

      • 'Admin' level permissions on the company's Directory tool.

Steps

Create a Configuration for a Specific Project

Follow these steps if you are a project user setting up an app configuration inside a single, specific project.

  1. Navigate to the specific project in Procore.

  2. On the top navigation bar, click the Select an App dropdown menu.

  3. Click App Management.

  4. Locate the App you want to configure and click View.

  5. Click the Configurations tab.

  6. Click Create Configuration.

  7. In the Projects field, ensure your current project is selected.

  8. Enter a Title for the configuration. (Note: App users will see this display name in their 'Select an App' menu.)

  9. Enter values for any required or optional Configurable Fields (e.g., a target Google Sheet URL).

  10. Click Create.

Create a Configuration from the Company Admin Tool

Follow these steps if you are a Company Administrator deploying an app to specific projects, globally to all projects, or at the company level.

  1. Navigate to the company-level Admin tool.

  2. Under 'Company Settings' or 'Administrative Settings', click App Management.

  3. Locate your target App, click View, and select the Configurations tab.

  4. Click Create Configuration.

  5. Define the scope and deployment of your configuration:

    • For specific project(s): Use the Projects dropdown menu to manually select the project(s) you want this configuration applied to.

    • For all projects (Global): Mark the Global Projects Config checkbox to apply this configuration automatically to all active and future projects in the company.

    • For the Company Level: Mark the Company Level Config checkbox to allow users to launch this app from the company-level header menu.

  6. Enter a Title for the configuration. (Note: App users will see this display name in their 'Select an App' menu.)

  7. Enter values for any required or optional Configurable Fields.

  8. Click Create.

See Also

Loading related articles...