---
schema_version: "1"
id: 82548692be382db8cbd474e3b6f13efd171c04c8046e27b500c3ef39c81c046f
title: Create Custom Settings Records
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/cs_add_data.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.cs_add_data.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 9fb54bfdc3cbb2851ca6cb133a6a5f64d48c73e7cf7f3561da72dbae86552434
description: After you define your custom settings and add fields, you can populate the fields with data.
products:
  - Salesforce Platform
  - Security
release: "264"
---
# Create Custom Settings Records

After you define your custom settings and add fields, you can populate the fields with data.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition">
        <colgroup>
          <col>
        </colgroup>
        <tbody>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Available in: Salesforce Classic and Lightning Experience.</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">
              <p>Available in: <strong>Group</strong>, <strong>Professional</strong>, <strong>Developer</strong>, <strong>Enterprise</strong>,
                <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Database.com</strong> Editions.
              </p>
              <p style="margin-bottom:0;">Packages aren’t
                available in <strong>Database.com</strong>.</p>
            </td>

          </tr>
        </tbody>
      </table> <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d123761e87">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d123761e87 ">Customize Application</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d123761e87 ">&nbsp;</td>

          </tr>
        </tbody>
      </table>

You can define one or more data sets. For list custom settings, each data set is named and can be accessed by that name using Apex, formula fields, and so on.

For custom settings that are hierarchies, the access level—user, profile, or organization—determines how you access the data. The user level is the lowest level, so it is used first, unless otherwise specified in your application. For example, you can specify different contact numbers for your application: one for the general user, and one that is only displayed for system administrators.

To add data to custom setting fields:

1. From Setup, enter Custom Settings in the Quick Find box, select **Custom Settings**, then click **Manage** next to a custom setting. Or from the detail page for a custom setting, click **Manage**.
2. Click **New** or **Edit** next to an existing data set.
3. Add or change data for custom settings that are lists.
    1. Specify or change the name for the data set. This name is used by Apex, formula fields, and so on.
    2. Enter or change data for all fields.
    3. Click **Save**.
4. Add or change data for custom settings that are hierarchies.
    1. For the default organization level values, enter or change the data for the fields. The default organization location is automatically populated.
    2. For profile or user level values, select either **Profile** or **User** from the Location picklist. Enter the name of the profile or user, or use the lookup dialog search. Then enter or change the data for the fields.
    3. Click **Save**.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/images/icon_note.png)

Note For a hierarchy custom setting, you can add only one record for a profile or user. Adding two records for the same profile or user results in an error.

#### See Also

- [Manage Custom Settings Data](https://help.salesforce.com/s/articleView?id=platform.cs_manage_data.htm&release=264.0.0&type=5 "After creating custom setting and adding fields, you can add records, then use the values in these records in your Apex code and validation rules.")
- [Add Custom Settings Fields](https://help.salesforce.com/s/articleView?id=platform.cs_add_fields.htm&release=264.0.0&type=5 "After you define custom settings, add fields to them. The custom fields contain the data used by the custom setting.")