Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Contact Roles on Opportunities entry
How-to guide

How to set up Contact Roles on Opportunities

Setup is mostly about customizing the role picklist and enforcing population through validation rules. The object and related list ship enabled in every edition above Group.

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

Setup is mostly about customizing the role picklist and enforcing population through validation rules. The object and related list ship enabled in every edition above Group.

  1. Customize the Role picklist to match your sales methodology

    Setup, Object Manager, OpportunityContactRole, Fields and Relationships, Role. Edit the picklist values to match MEDDIC, MEDDPICC, or whatever methodology your team uses.

  2. Confirm the Contact Roles related list is on the Opportunity page layout

    Setup, Object Manager, Opportunity, Page Layouts. Drag Contact Roles from the Related Lists palette to the body if it is not already there. Repeat for each layout your sales team uses.

  3. Build a validation rule to enforce Primary Contact Role

    A common rule blocks stage transition past Discovery without a Primary Contact Role. The formula references a custom Primary Contact Role formula field that returns the Primary OpportunityContactRole ContactId.

  4. Set up the Opportunities with Contact Roles report type

    This report type is standard but may be hidden in some org configurations. Confirm it is available, then build a sample report grouped by Role to show pipeline coverage.

  5. Train reps on the role values

    Once the picklist matches the methodology, train reps on which value means what. The single biggest factor in Contact Role usefulness is rep discipline, not technical configuration.

  6. Add Contact Role coverage to pipeline review dashboards

    Sales managers should see Contact Role completeness alongside Opportunity stage, amount, and close date. The discipline shows up when leaders demand to see Champion identification before they take a deal seriously.

Gotchas
  • Setting a new Primary unsets the existing one without warning. Reps occasionally lose track of who the Primary was after editing.
  • Reports on Opportunity that filter on a specific Contact Role value require the Opportunities with Contact Roles report type, not the standard Opportunities report type.
  • Flow native support for Contact Roles arrived in 2022. Older Flows often use Apex invocable actions; check before assuming they upgrade cleanly.
  • AccountContactRelation is a separate object from OpportunityContactRole. Setting up one does not configure the other.
  • If Person Accounts are enabled, Contact Roles on Opportunities use the Contact half of the Person Account. The relationship works but the data model is subtle; document for your team.

See the full Contact Roles on Opportunities entry

Contact Roles on Opportunities includes the definition, worked example, deep dive, related terms, and a quiz.