Create a Record Label to Appear on the Record Status Dashboard and Instrument

Create a Record Label to Appear on the Record Status Dashboard and Instrument

Description

Set a Record Label that will appear on the Record Status Dashboard and Instruments in addition the Record ID.

Purpose

This feature has several uses including but not limited to:

  1. Include a study specific ID (RCT0001), name, or other identifier when using a public survey in which record IDs are automatically generated

  2. Include an area of study when collecting data for a trainee application

  3. Include a grant title, grant submission cycle, etc. for a project requesting grant applications, i.e., mock study section

  4. Include a sample ID for a repository of metadata for physical specimens

 

Steps by Step Instructions

  1. Navigate to Project Setup

    image-20260108-182942.png
  2. In the Enable optional modules and customizations section, select Additional Customizations

    image-20260108-183116.png
  3. Click the checkbox next to Set a Custom Record Label

  4. Type the Record Label into the text box next to Custom Record Label. This can be static text, piped variables by placing a variable name within square brackets [], or a combination of both.

    image-20260108-183414.png
  5. Scroll to the bottom of the Additional Customizations dialog box and click Save

  6. If there are no records in the project, create a test record

  7. Navigate to the Record Status Dashboard. The Record Label should be displayed next to the Record ID

    image-20260108-183807.png
  8. Open an instrument for a record. The Record Label will appear at the top of the instrument next to the Record ID

image-20260115-195240.png

 

Troubleshooting

  1. If piped variables are included and:

    1. Display as a variable name with square brackets, check to ensure the variable name in the record label matches exactly the variable name in the Online Designer or Codebook

    2. Have an underline and no data, ensure there is data for the fields piped for that specific record