Summary
This module may be used for making changes to the project, such as adding new fields, modifying or deleting existing fields, by using an offline method called the Data Dictionary. The Data Dictionary is a specifically formatted CSV file within which users may construct their project fields and afterward upload the file to commit the changes to the project. (Note: Once the file has been uploaded, changes will NOT immediately be made but will be displayed and checked for errors to ensure that all the formatting in the Data Dictionary is correct before official changes are made to the project.)
How to access and update the Data Dictionary
To access and modify the Data Dictionary, navigate to the project you would like access and/or edit the Data Dictionary for.
- Click on Dictionary under the "Project Home and Design" header on the left side of your screen.
![](https://atlas.utdallas.edu/TDPortal/Images/Viewer?fileName=ac7668fb-5727-4d9a-8803-e5b318627543.png&beidInt=2)
- Click on "Download the current Data Dictionary"
- Open the downloaded Excel file and edit as necessary. You can add, delete, and modify fields by adding, deleting, or modifying the rows of the Excel sheet, respectively.
- Once all edits are made, save the file as a CSV file.
- Navigate back REDCap and in the "Upload your Data Dictionary file" box, select the correct format for your date/datetime fields and select the delimiter of your CSV file. (Note: The default delimiter when saving a CSV file is comma.)
![](https://atlas.utdallas.edu/TDPortal/Images/Viewer?fileName=acc4400a-38a3-489a-a2c7-8b4be38859bb.png&beidInt=2)
- Click on Choose File and select your file.
![](https://atlas.utdallas.edu/TDPortal/Images/Viewer?fileName=80fada07-8d1a-4897-8d9d-826d99c64605.png&beidInt=2)
- Once the name of your file appears, click on Upload File.
![](https://atlas.utdallas.edu/TDPortal/Images/Viewer?fileName=da9eacb0-41c9-4410-a9c5-121e3f69dcff.png&beidInt=2)
- Changes will be made after REDCap has checked the file for any errors.
- If there are any errors in your file, this text box will appear. Please read through the errors and make any necessary edits to the Data Dictionary file.
- Click RETURN TO PREVIOUS PAGE and repeat steps 5-7 until no errors persist.
![](https://atlas.utdallas.edu/TDPortal/Images/Viewer?fileName=d449c1fb-1add-4ad4-8a5f-865af102b19c.png&beidInt=2)
- If there are no errors in your file, this text box will appear and your data dictionary is ready to be updated.
![](https://atlas.utdallas.edu/TDPortal/Images/Viewer?fileName=7a34a9d1-fb26-4094-926d-4e8fd83b6851.PNG&beidInt=2)
- If all edits appear acceptable, click on Commit Changes in the blue text box. If there any concerns with the changes, click "Cancel" to cancel the upload.
![](https://atlas.utdallas.edu/TDPortal/Images/Viewer?fileName=82b0d653-719f-4e23-92c2-9313e056674d.png&beidInt=2)
- Once this message appears, all changes have been committed
![](https://atlas.utdallas.edu/TDPortal/Images/Viewer?fileName=b33e6b34-1845-4698-9b4b-251f86fa1ba2.PNG&beidInt=2)