Skip to main content
New tool CRON Expression Builder — preview next run times before you schedule Apex. Open the builder →
Diagram illustrating best practices for naming conventions in Salesforce Flows for better automation clarity.
Flow

Best Practices for Naming Conventions in Salesforce Flows

Practical naming conventions for Salesforce Flows: patterns, element-level tips, versioning, and governance to keep your automation clear and maintainable.

The short answer

This article outlines best practices for creating clear, consistent naming conventions for Salesforce Flows and canvas elements. It establishes a repeatable naming pattern and governance rules to improve maintainability, searchability, and team collaboration.

Key takeaways Adopt the standard naming pattern of object, trigger, action, and extra information to make Flows easy to identify and search. Replace default element labels with descriptive action names or type prefixes so logic is clear directly on the canvas. Reserve the Flow description field for developer notes, ownership details, and issue tracking references rather than embedding them in the name. Document and enforce a formal naming policy during reviews that defines required segments, abbreviations, and maximum character lengths.

Why Naming Conventions Matter in Salesforce Flows

Clear, consistent naming conventions make Flows easier to understand, maintain, and govern — especially in orgs with multiple admins and developers. Good names reduce onboarding time, speed troubleshooting, and prevent accidental edits or duplicate automation.

Core Principles

Apply these core principles when naming Flows and Flow elements:

  • Be descriptive but concise: capture the Flow's purpose in a short phrase.
  • Use a consistent structure: include object, action, trigger type, and environment.
  • Prefer readability over cleverness: avoid abbreviations that aren’t universally understood.
  • Include version or status when relevant: e.g., Draft, Active, or a semantic version.

Suggested Naming Pattern

A repeatable pattern helps searchability and governance. One recommended pattern is:

<Object> - <Trigger> - <Action> - <ExtraInfo>

Examples:

  • Contact - Before Save - Set Preferred Language
  • Opportunity - After Save - Create Renewal Task
  • Case - Record-Triggered - Escalate to Manager - SLA15

Element-Level Naming

Name elements inside Flow (like Get Records, Assignment, Decision) using the same clarity:

  • Get Primary Account instead of Get_1
  • Assign: SetRenewalDate instead of Assignment2
  • Decision: Is High Value Account? instead of Decision_3

Prefix element types optionally to make them immediately identifiable in the Flow canvas (e.g., G - Get Account, A - Set Flags, D - Check Status).

Include Metadata in Names

Embedding metadata like the trigger type and target object reduces ambiguity:

  • Trigger type: Record-Triggered, Scheduled, or Screen.
  • Action intent: Create, Update, Notify, Validate.
  • Scope or conditions: e.g., SLA30, HighValue, AfterClose.

Versioning and Drafts

Flows update frequently. Capture version or status info to distinguish work-in-progress from production:

  • Opportunity - After Save - Send Invoice - v1.2
  • Lead - Screen - Qualification - Draft

Avoid storing transient developer notes in the name; instead use the Flow description field for implementation details, logic notes, or testing instructions.

Governance and Naming Policy

Document a short naming policy and enforce it during change reviews:

  • Define required segments (object, trigger, action).
  • Set maximum length guidance (e.g., 80 characters) to keep names readable in the UI.
  • Agree on abbreviations and reserved prefixes (for managed packages or integrations).
  • Use the Flow description to store owner, last modified intent, and Jira/Issue references.

Searchability Tips

Make names easy to find using Salesforce search and external documentation:

  • Include consistent keywords (e.g., Notify, Validate, Assign).
  • Tag Flows with category-like prefixes if your org supports it (e.g., INT- for internal, INTG- for integrations).
  • Keep the most important terms at the beginning of the name.

Examples — Good vs. Bad

Compare choices:

  • Good: Account - Before Save - Normalize Phone
  • Bad: Flow_update1
  • Good: Case - After Save - Notify Support - SLA72
  • Bad: CaseFlow

Checklist Before Finalizing a Flow Name

  • Does the name include the object and trigger type?
  • Is the intended action clear?
  • Is it consistent with existing naming patterns in the org?
  • Is it short enough to be readable on the canvas and in lists?
  • Is additional context better placed in the description?

Conclusion

Consistent naming conventions for Flows reduce risk, improve maintainability, and increase clarity for admins and developers. Create a simple, documented pattern (object — trigger — action — extra info), enforce it during reviews, and use the description field for deeper technical notes.

Frequently asked questions

What is the recommended naming convention for Salesforce Flows?

Use the structured pattern `<Object> - <Trigger> - <Action> - <ExtraInfo>`, such as `Opportunity - After Save - Create Renewal Task`. This pattern clearly identifies the target object, execution context, and intended outcome.

How should you name elements inside a Salesforce Flow?

Give elements clear, descriptive names reflecting their purpose, such as `Get Primary Account` instead of generic defaults like `Get_1`. You can also add optional prefixes like `G -` or `Decision:` to make element types immediately identifiable on the canvas.

Where should you document implementation notes for a Salesforce Flow?

Store implementation details, testing notes, owner info, and Jira references in the Flow description field. Keeping transient developer notes out of the Flow name prevents clutter and keeps names readable.

Newsletter

One email every Tuesday

New guides, tool updates, and the release-note changes that break things.

No spam. Unsubscribe in one click.

Comments

Loading comments...

Leave a Comment