# Enable Substances Learn how to update your Vault's configuration to enable tracking Substances in individual Products. ## About the Feature Vault Safety can now track substances and their use in individual products. When adding a Case Product that is associated with a pre-configured Substance, the substance information is mapped to the Case Product. This feature was added to Vault Safety in 20R2 and is available in Vaults deployed in 20R2 or later by default. For Vaults deployed in 20R1 or earlier, an administrator must perform the following configuration changes to enable this feature. Manage Products and Manage Studies provide more information about this feature. ## Update Permission Sets for Object Access As an Administrator, we recommend that you update the relevant permission sets for the following objects to comply with new object configurations. We also recommend that you enable the permission to Read Substance and Product Substance objects for all users. For users who will be managing Products, you should enable the permission to Edit Substance and Product Substance objects. 1. In the **Admin** area, go to **Users & Groups > Permission Sets**, and then select the permission set you want to update. 2. In the permission set, select **Objects**, and then select **Edit**. 3. For the respective objects, select the applicable checkboxes to grant permissions to the following objects. * Substance * Case Product Substance * Product Substance * Reporting Family Member Type 4. Select **Save**. **Result** Your permission set has been updated with your selected object permissions. ## Configure the Product and Drug Layout to Insert Related Object Section for Substances 1. In the **Admin** area, go to **Configuration > Objects > Product > Layouts**, and then select **Product Detail Page Layout**. 2. Select **Insert Section** at the top of the page, and then select **Related Object**. A box will appear. 3. Fill in the specified fields: * **Related Object**: (Required) Enter `Product Substance`. * **Section Label**: (Required) Enter `Substances`. * **Section Name**: (Required) Enter `substance`.
4. Select **Done**. 5. Select **Save** at the top of the page. 6. Repeat the above steps for **Drug Page Layout**. **Result** Your Product and Drug records are now configured to have the Related Object section for Substances.
## Configure the Substance Layout to Insert Related Objects Section for Products 1. In the **Admin** area, go to **Configuration > Objects > Substance > Layouts**, and then select **Substance Detail Page Layout**. 2. Select **Insert Section** at the top of the page, and then select **Related Object**. A box will appear. 3. Fill in the specified fields: * **Related Object**: (Required) Enter `Product Substance`. * **Section Label**: (Required) Enter `Products`. * **Section Name**: (Required) Enter `product`.
4. Select **Done**. 5. Select **Save** at the top of the page. **Result** Your Substance records are now configured to have the Related Object section for Product Substance. ## Configure the Case Product Substance Layout to Add Strength (Number) and Strength (Unit) Fields 1. In the **Admin** area, go to **Configuration > Objects > Case Product Substance > Layouts**, and then select **Case Product Substance Detail Page Layout**. 2. There are two options available to add these fields * In the Details section, select **Add**, and then select Add Combined Strength Control. This is the combined Strength control that combines the **Strength (Number)** and **Strength (Unit)** fields together. We recommend you use this option. * In the Substance Details section, select **Add**, and then select **Strength (Number)** and **Strength (Unit)**. 3. Select **Save** at the top of the page. **Result** Your Case Product Substance records are now configured to display the **Strength** field(s). ## Configure the Study Product Substance Layout to Include the New Substance Field 1. In the **Admin** area, go to **Configuration > Objects > Study Product Substance > Layouts**, and then select **Study Product Substance Detail Page Layout**. 2. In the Details section, select **Add**, and then select Substance Name. 3. Select **Save**. **Result** Your Study Product Substance records are now configured to display the Substance field. ## Verify the Case Product Layout Includes Substances Most Vaults include the Substances section on the Case Product Layout by default. However, some Vaults based on older templates may not have this configuration. Go to **Configuration > Objects > Case Product > Layouts**, and verify that there is a Substances related objects section in the following Case Product layouts: * Biologic Page Layout * Case Product Detail Page Layout * Drug Page Layout * External Product Page Layout * Study Product Page Layout If the section is not present, insert a related object section for Substances. ## (Optional) Remove Study Product Substance from Layouts This configuration is optional but highly recommended. Update this configuration on the following layouts: * Biologic Page Layout * Drug Page Layout * External Product Page Layout * Study Product Detail Page Layout 1. In the **Admin** area, go to **Configuration > Objects > Study Product > Layouts**, and then open the layout. 2. Remove the **Substances** related object section. 3. Save the layout and repeat these steps for each of the Study Product layouts mentioned above. **Result** The Substance section has been deleted from your Study Product records. ## (Optional) Remove Study Product Substance from Layouts You can optionally update your Vault's Business Admin (Quick Access) navigation tab to add Substances as a subtab for convenient navigation. To add a subtab, go to **Configuration > Vault Navigation > Tabs**.