Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Field entry
How-to guide

How to create a new custom field on an object

Creating a custom field is a Setup task that takes about 5 minutes for the basic configuration. The choice of data type determines what additional configuration the wizard asks for.

By Dipojjal Chakrabarti · Founder & Editor, Salesforce DictionaryLast updated May 21, 2026

Creating a custom field is a Setup task that takes about 5 minutes for the basic configuration. The choice of data type determines what additional configuration the wizard asks for.

  1. Navigate to the object''s field manager

    Setup, then Object Manager, then the target object, then Fields and Relationships. Click New.

  2. Select the data type

    Pick from the data type wizard: Text, Number, Currency, Picklist, Date, Checkbox, Lookup, Formula, etc. Each type has different downstream configuration.

  3. Configure type-specific settings

    For Text: length (up to 255). For Picklist: values and default. For Lookup: target object. For Formula: the formula expression and return type. For Roll-Up Summary: aggregate function and master-detail relationship.

  4. Set Field Label, API Name, and Description

    Label is the user-visible name. API Name auto-derives from the label (Last_Login_Date_c). Description is for admins.

  5. Set Field-Level Security

    Pick the profiles that can read and edit the field. Default is Read+Edit for all profiles; restrict if the field is sensitive.

  6. Add to page layouts and save

    Pick which page layouts the field should appear on. Save. The field is now created and visible to authorized users.

Mandatory fields
Field Labelrequired

User-visible name. Appears in UI and reports.

Data Typerequired

Determines the field''s storage and behavior.

API Namerequired

Permanent identifier used in code. Custom fields end in __c.

Field-Level Securityrequired

Per-profile read/edit access.

Gotchas
  • API Name is permanent. Pick it thoughtfully; you cannot rename it without recreating the field.
  • Custom field limits apply per object (typically 100-500 depending on edition). Hitting the limit blocks new field creation until cleanup.
  • Formula fields recompute on every read. Heavy formulas across many rows can slow reports and SOQL queries.
  • Field-Level Security must be set explicitly. Default is visible to all; sensitive fields need restrictive FLS or accidental data exposure happens.

See the full Field entry

Field includes the definition, worked example, deep dive, related terms, and a quiz.