Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Custom Help entry
How-to guide

How to set up Custom Help in Salesforce

Custom Help is the admin-defined help text that shows up next to fields and on object detail pages — context-specific guidance for users. Per-field Help Text appears as a ? tooltip; per-object Custom Help can replace the default help URL with custom internal documentation.

By Dipojjal Chakrabarti · Editor, Salesforce DictionaryLast updated Apr 20, 2026

Custom Help is the admin-defined help text that shows up next to fields and on object detail pages — context-specific guidance for users. Per-field Help Text appears as a ? tooltip; per-object Custom Help can replace the default help URL with custom internal documentation.

  1. For per-field Help Text: Object Manager → object → Fields & Relationships → click into the field → Edit

    On any custom or standard field. Help Text field is in the field-edit form.

  2. Type the help guidance

    Plain text or basic HTML. Up to 510 characters. Aim for actionable: "Enter the customer's primary contact email — used for billing notifications."

  3. Save

    Help Text now shows as a ? tooltip next to the field's label on Page Layouts.

  4. For per-object Custom Help: Object Manager → object → Custom Help

    Override the default Salesforce help URL. Replace with your internal Confluence page, Knowledge article, or any URL.

  5. Set Help Page Type and Help Page URL

    Help Page Type: standard URL / Visualforce page. Most orgs use a URL pointing at internal docs.

  6. Save

    Users clicking Help on the object now land on your custom page.

Key options
Per-Field Help Textremember

Up to 510 chars, plain text, ? tooltip.

Per-Object Custom Helpremember

Override the default help URL.

Help Page Typeremember

URL / Visualforce.

Gotchas
  • Help Text is up to 510 characters. Long help is truncated — keep it concise; for detailed guidance, link to a Knowledge article in the Help Text.
  • Help URL overrides apply org-wide for the object. Different teams that want different help pages on the same object are out of luck — only one URL per object.
  • Help Text shows on standard layouts but Lightning Pages may suppress it depending on configuration. Test that the ? tooltip appears in Lightning before assuming users see it.

See the full Custom Help entry

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