Create and Apply a Fieldset

Things to consider

  • In this step, you are deciding what information (or data fields) will be associated with this Correspondence Type. The fields you add will dictate what information the project teams will collect “out in the wild” when they use this Correspondence Type on an actual project. For example, does this Correspondence Type need a due date, an attachment field, or a place to document cost impact?

  • You can mark fields as “required,” “optional,” or hide them altogether.

  • You can add custom fields, to further customize the Fieldset.

  • You can create multiple different Fieldsets for a given Correspondence Type, in order to accommodate variations on data needs for different project types.

Steps

After you have created the correspondence type, you can then finish creating the fieldset for the correspondence type.

Update the Fieldset Settings

Start at step 6 below:

  1. Navigate to the Company level Admin tool.

  2. Under 'Tool Settings', click the tool you want to create configurable fieldsets for.

  3. Click the Fieldsets tab.
    admin-fieldsets-tab.png
    Note: Tools without other settings in the Company level Admin tool will open to this page automatically.

  4. Click Create Fieldset and if required, select the fieldset type.

  5. Enter a name for the fieldset, then click Create.

  6. On the 'Edit Fieldset' page, each field name has the following options:

    • Click the toggle to the ON icon-toggle-on.png position to make the field visible in the section.
      OR
      Click the toggle to the OFF icon-toggle-off.png position to hide the field in the section.
      Note: A icon-toggle-on2.png icon indicates that the field is visible by default and cannot be changed to hidden.

    • Mark the 'Required' checkbox to designate the field as required.
      OR
      Clear the 'Required' checkbox to designate the field as optional.
      Notes:* Fields without a checkbox are optional by default and cannot be changed to required.* A gray marked checkbox icon-checkbox-marked-grayed-out.png indicates that the field is required by default and cannot be changed to optional.

  7. Optional: If available, click Create Section to create a new section. See Create Custom Sections.

  8. Click Save.

  9. In the 'Apply changes to [#] project(s)?' window, click Assign Projects to add the fieldset to projects.

    • In the 'Assign Projects' window, mark the checkbox next to each project you want to apply the fieldset to and click Update.

    • In the 'Apply changes to [#] project(s)?' window, click Confirm.

  10. Optional: To set a fieldset as the default for new projects, click the icon-ellipsis-options-menu.png icon at the end of its row on the 'Fieldsets' tab and select Set as New Project Default.

    Note icon Note

    Projects created from a project template that includes fieldsets will inherit the fieldsets from the project template instead of your company's default fieldsets. See Configure a Project Template.

Optional: Add a Custom Field to the Fieldset

Start at step 3 below:

  1. Click the Fieldsets tab.

  2. Click Edit next to the fieldset you want to add the custom fields to.
    OR
    Click Create New to create a new fieldset. See Create New Configurable Fieldsets.

  3. Optional: Add the field to a custom section**.** See Create Custom Sections and What are custom sections and which Procore tools support them?

  4. Scroll toward the bottom of the page and click Add Custom Field.

  5. Click Create New.

  6. Complete the following information for the new field:

    • Field Name: Enter a name for the field.

    • Field Type: Select the type of field you want to create.
      Note: Some field types may not be available for all tools.

      Expand or Collapse Field Type Options

      • Checkbox: The field will be a checkbox that can be marked or cleared.

      • Company: The field will be a drop-down menu that allows users to select a Company from the Project Directory.

      • Date: The field will allow the user to select a calendar date.

      • File Uploads: The field will allow attachments to be added from supported tools in Procore or the user's computer.

      • Location: The field will be a drop-down menu that allows users to select an existing location.

      • Multi Select: The field will be a drop-down menu that allows users to select multiple values.

      • Number: The field will allow a number value to be entered.
        Note: When a user enters a number into a 'Number' custom field with no decimal value or with two zeroes after a decimal point, PDF exports with the field will show a decimal value of .0 for the number. For example, if a user enters 123 or 123.00, the PDF export will show the number as 123.0.

      • Plain Text (Short): The field will be a free text field.

      • Project Directory User (Multi Select): The field will be a drop-down menu that allows users to select one or more users from the Project Directory.

      • Project Directory User (Single Select): The field will be a drop-down menu that allows users to select a user from the Project Directory.

      • Read Only Entry: The field will allow you to type a message, such as instructions, in the text box, which will be visible on an item.

      • Rich Text (Long): The field will be a rich text field that supports paragraphs to allow longer responses and bold, italic, and underlined text.

      • Single Select (Dropdown): The field will be a drop-down menu that allows users to select one value.

      • Tool User (Single Select): The field will be a drop-down menu that allows users to select a user with 'Read Only' or higher permissions to the tool.

      • Date / Time: The field will be a combination of a calendar menu and a time of day entry.

  7. For Multi Select and Single Select field types, complete the following steps to add options:

    1. Click Add Options.

    2. Enter the option in the field.

    3. For each additional option needed, click Add Option and enter the option.

    4. Click Save Options.

    5. Click Done.

  8. Click Create and the field will automatically be added to the bottom of the fieldset.

  9. Click the toggle to the ON icon-toggle-on.png position to make the custom field visible in the section, or click to the OFF icon-toggle-off.png position to hide the custom field.

  10. If the custom field should be required, mark the 'Required' checkbox. Otherwise, the field will be optional.

  11. Click Save.

  12. If the fieldset is already applied to one or more projects, click Apply to Existing.
    OR
    If you have just created a new fieldset, click Assign Projects and begin at step 3 of the Apply a Fieldset with Custom Fields to Projects section below.

  13. Optional: Click and drag on the reorder grip icon-reorder-grip.png icon to rearrange the order that the custom fields will appear on a fieldset.
    Note: Procore Standard fields cannot be reordered.

Optional: Add a Custom Section to the Fieldset to Organize Custom Fields

Start at step 5 below:

  1. Navigate to the Company level Admin tool.

  2. Under 'Tool Settings', click the tool you want to create a custom section for.

  3. Click Fieldsets.

  4. Click Edit next to the fieldset you want to add a custom section to.
    OR
    Click Create New to create a new fieldset. See Create New Configurable Fieldsets.

  5. Click +Add Section.

  6. In the 'Add Section' window, enter a name for the section and click Add.

  7. To add one or more custom fields to the new custom section, click Add Custom Field under the custom section's name.

  8. Click Choose from Existing to add an existing custom field.
    OR
    Click Create New to create and add a new custom field. See Create Custom Fields Within a Fieldset.

  9. Repeat steps 5-8 to add more custom sections.

  10. Optional: To rearrange custom sections, follow these steps:

  • Hover your cursor next to the custom section until the grip icon icon-reorder-grip.png displays.

  • Click on the grip icon and drag the custom section above or below another custom section.

  1. Optional: To move a custom field to a different custom section, follow these steps:

  • Hover your cursor next to the custom field until the grip icon icon-reorder-grip.png displays.

  • Click on the grip icon and drag the custom field above the Add Custom Field button in the custom section you want to move it to.

  1. Click Save.

Finish Creating Your Fieldset and Apply it to Projects
  1. After you have added one or more custom fields to the fieldset, click Save.

  2. In the 'Apply changes to [#] project(s)?' window:

    Important icon Important

    The Correspondence tool will not display on a project until at least one correspondence type has been created and a fieldset for at least one correspondence type has been applied to the project.

    • Click Apply to Existing to save your changes to the fieldset on projects that the fieldset is already applied to.
      OR

    • Click Assign Projects to add or remove the fieldset from projects.* In the 'Assign Projects' window, mark the checkbox next to each project you want to apply the fieldset to and click Update.* In the 'Apply changes to [#] project(s)?' window, click Confirm.

  3. Optional: To set a fieldset as the default for new projects, click the icon-ellipsis-options-menu.png icon at the end of its row on the 'Fieldsets' tab and select Set as New Project Default.