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.
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.
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.
Follow these steps if you are a project user setting up an app configuration inside a single, specific project.
Navigate to the specific project in Procore.
On the top navigation bar, click the Select an App dropdown menu.
Click App Management.
Locate the App you want to configure and click View.
Click the Configurations tab.
Click Create Configuration.
In the Projects field, ensure your current project is selected.
Enter a Title for the configuration. (Note: App users will see this display name in their 'Select an App' menu.)
Enter values for any required or optional Configurable Fields (e.g., a target Google Sheet URL).
Click Create.
Follow these steps if you are a Company Administrator deploying an app to specific projects, globally to all projects, or at the company level.
Navigate to the company-level Admin tool.
Under 'Company Settings' or 'Administrative Settings', click App Management.
Locate your target App, click View, and select the Configurations tab.
Click Create Configuration.
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.
Enter a Title for the configuration. (Note: App users will see this display name in their 'Select an App' menu.)
Enter values for any required or optional Configurable Fields.
Click Create.
If the app you're installing is listed as a Data Connection app, continue with the steps below.
After installing the app, navigate to the App Management tool from the Select an App menu in Procore.
Click View next to the app you're configuring.
Click the Permissions tab.
Select the project(s) the app will be available in from the Permitted Projects drop-down menu.
Click Add.
Once the integration is installed, go to the Company Level Permissions tool.
Click the Projects Permissions Template tab.
Create a Global permission template that provides the permissions the app lists as required. See Create Permission Template for detailed instructions.
Note: It's best to name the permission template with the app's name to easily identify it.
Go to the Company level Directory.
Search for the app name to locate its "user" account in the Directory.
Click Edit next to the user account.
In the permissions area of the user record, click the Select Default Permission Template option.
Choose the template you've set up for the app, then click Apply.
Note: Do NOT manually adjust permissions for the app's user account in the permissions grid in the Company Directory tool. A permission template must be applied.
Next, mark the checkbox for Add [app-user-name] to all new projects.
This setting will add the ‘App User’ to all new Procore projects moving forward.
To add the ‘App User’ to existing projects, click Add All next to Projects this user does not belong to.
Click Save.
Immediately after clicking Install, a Create Configuration modal will appear.
You can use this modal to create an initial App Configuration now, or click Skip to create a configuration and apply it to projects at a later time.
Upon confirming the installation of a Data Connection app, you will prompt the Add Permitted Projects workflow:
Use the Add Permitted Projects modal to select one or more projects that you want the Data Connection App to have access to.
Click Add to grant immediate access.
Alternative: If you prefer to manage project access later, click Skip.
If you skipped the initial setup or need to change project permissions for a Data Connection app on specific projects later, use the following method:
Navigate to the App Management tool from the Select an App menu in Procore.
Click View next to the specific app you want to configure.
Click the Permissions tab.
Select the project(s) you want the app to be available in from the Permitted Projects drop-down menu.
Click Add.
To ensure a Data Connection app functions flawlessly across your entire company portfolio without manual project-by-project assignment, you must apply a global template to its DMSA user account:
Go to the Company Level Permissions tool.
Click the Projects Permissions Template tab.
Create a Global permission template that provides all the tool permissions the app lists as required.
Note: It is best practice to name this permission template after the app itself so it can be easily identified later.
Navigate to the Company level Directory tool.
Search for the app's name to locate its automatically generated "user" account in the Directory list.
Click Edit next to that app user account.
Scroll to the permissions area of the user record and click the Select Default Permission Template option.
Choose the global template you set up for the app, and click Apply.
Important: Do NOT manually check or adjust individual tool permission boxes inside the permissions grid on this screen. A dedicated permission template must be applied directly to the account.
Mark the checkbox labeled "Add [app-user-name] to all new projects" under the 'New Project Settings'. This ensures the App User is added to all new Procore projects moving forward.
To push the app out to your active portfolio, locate the section titled 'Projects this user does not belong to' and click Add All.
Click Save to finalize your changes.
Loading related articles...