# Enable the New Substance Name Field in the Product Library

Learn how to configure your Vault to export 250-character Substance Names for greater E2B compliance.

## About the Feature

To match E2B guidance, the Vault Safety Product Library now supports up to 250 characters when adding Substance Names. This feature means that more accurate Substance descriptions can be entered, improving compliance on E2B Transmissions in the following data elements:

* **E2B(R3):** G.k.2.3.r.1 Substance / Specified Substance Name
* **E2B(R2):** B.4.k.2.2 Substance / Specified Substance Name

When your Product Library is configured with the new 250-character **Substance Name** field, that value is populated during Case processing for Case Product Substance Names and Localized Case Product Substance Names. If the new field is blank, the value in the existing 128-character **Substance Name** field is populated. The value on the Case or Localized Case is then exported to E2B reports.

In the 23R2 release, the 250-character **Substance Name** field will be included in the Vault Safety template. For Vaults created earlier, you can complete the following configuration outlined below. Then, see <a href="/en/lr/01215/#substance-records">Manage Products: Add Substances</a> for more information about using this feature.

## Configure the Substance and Localized Substance Objects

To export 250-character Substance Names from Cases and Localized Cases on E2B reports, you must update the **Substance** and **Localized Substance** layouts. 

In addition, we recommend configuring the **Substance** and **Localized Substance** objects so that Business Admins can enter values in only the new **Substance Name** field. This overrides the requirement to enter a value in the existing 128-character **Substance Name** field.

### Update the Substance Layout

Complete the following steps to add the **Substance Name** field that supports 250 characters to the **Substance** layout.

1. Go to **Admin > Configuration > Objects > Substance > Layouts > Substance Detail Page Layout**.
2. In the **Details** section, select **Add**, and then add the **Substance Name** field.
3. Select **Save**.

<div class="note-border alert-info">
  <div class="alert alert-info" role="alert">
    <div><i class="far fa-info-circle"></i></div>
    <div class="alert-text">
      <p><strong>Note</strong>: To differentiate the Substance Name fields, you can edit the label of either the original <strong>Substance Name</strong> (<code class="language-plaintext highlighter-rouge">name__v</code>) or the new <strong>Substance Name</strong> (<code class="language-plaintext highlighter-rouge">substance_name__v</code>) field. Go to the <strong>Fields</strong> tab, select a field, and then edit the <strong>Label</strong>.</p>
    </div>
  </div>
</div>



### (Optional) Configure Substance Name Entry on Substances

Complete the following steps to make the 128-character **Substance Name** field read-only, so that Business Admins must enter values only in the 250-character **Substance Name** field.

1. Go to **Admin > Configuration > Objects > Substance > Fields**.
2. Select the **Substance Name** (`name__v`) field.
3. Select **Edit**.
4. In the **Options** section, select the **System manages field value (read-only)** checkbox.<br>**Result:** The **Value Format*** field is populated with "VV-{######}" and the **Starting Number** field is populated with "1".
5. Select **Save**.

### Update the Localized Substance Layout

Complete the following steps to add the **Substance Name** field that supports 250 characters to the **Localized Substance** layout.

1. Go to **Admin > Configuration > Objects > Localized Substance > Layouts > Localized Substance Detail Page Layout**.
2. In the **Details** section, select **Add**, and then add the **Substance Name** field.
3. Select **Save**.

<div class="note-border alert-info">
  <div class="alert alert-info" role="alert">
    <div><i class="far fa-info-circle"></i></div>
    <div class="alert-text">
      <p><strong>Note</strong>: If you edited a <strong>Substance Name</strong> label on the <strong>Substance</strong> object, we recommend making the same change on the <strong>Localized Substance</strong> object.</p>
    </div>
  </div>
</div>



### (Optional) Configure Substance Name Entry on Localized Substances

Complete the following steps to make the 128-character **Substance Name** field read-only, so that Business Admins must enter values only in the 250-character **Substance Name** field.

1. Go to **Admin > Configuration > Objects > Localized Substance > Fields**.
2. Select the **Name** (`name__v`) field.
3. Select **Edit**.
4. In the **Options** section, select the **System manages field value (read-only)** checkbox.<br>**Result:** The **Value Format*** field is populated with "VV-{######}" and the **Starting Number** field is populated with "1".
5. Select **Save**.