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

Create a Lookup Field on a custom object

Lookup Field creation is a few clicks. The decisions (parent object, cascade behavior, lookup filter) matter more than the click path.

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

Lookup Field creation is a few clicks. The decisions (parent object, cascade behavior, lookup filter) matter more than the click path.

  1. Open Fields & Relationships

    Setup, Object Manager, the child object, Fields & Relationships, click New.

  2. Choose Lookup Relationship

    Pick the Lookup Relationship field type. Master-Detail is for hard parent-child; Lookup is for the soft version.

  3. Pick the parent object

    Choose which object the lookup points to. Multiple lookups to the same parent are supported.

  4. Set field label, name, and required flag

    Enter the field label and API name. Decide whether the lookup is required.

  5. Configure parent-delete behavior

    Pick Don''t Allow Deletion, Clear the Field, or Cascade Delete. Default is Clear.

  6. Add a lookup filter if needed

    Configure lookup filter criteria to scope the dialog''s search results.

  7. Add to page layouts and FLS

    Place the field on the relevant page layouts. Configure field-level security per profile.

Mandatory fields
Field typerequired

Lookup Relationship.

Parent objectrequired

The target of the lookup.

Field label and API namerequired

User-facing name and programmatic identifier.

Parent delete behaviorrequired

Decides what happens to the child if the parent is deleted.

Optional lookup filterrequired

Narrows the dialog''s search scope.

Gotchas
  • Lookup Fields are soft links. Children survive parent deletes by default (Clear behavior); the cascade behavior is configurable but defaults to soft.
  • Polymorphic lookups (Task.WhatId, Event.WhatId) cannot be queried with dot notation across all parent types. Use TYPEOF for polymorphic queries.
  • Lookup filters can be too restrictive. Test the filter against real user scenarios; over-filtering blocks legitimate workflows.
  • Converting Lookup to Master-Detail is possible only when every child record has a populated parent. Required-from-day-one Lookup fields convert cleanly; optional ones often don''t.

See the full Lookup Field entry

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