EnablementProgramDefinition Metadata Architecture

Architectural Overview#

EnablementProgramDefinition defines the end-to-end curriculum, milestone sequences, and learning tasks for Salesforce Sales Enablement. Designed to ramp revenue teams faster, enablement programs combine content consumption (Trailhead, external videos) with experiential milestone activities that verify actual in-app execution.

From an application lifecycle management (ALM) perspective, storing enablement programs as metadata allows revenue operations teams to develop, test, and validate learning paths in sandbox environments before packaging and promoting them into production.

Directory and File Conventions#

EnablementProgramDefinition components are organized inside the enablementProgramDefinitions directory.

Key Metadata Fields#

The EnablementProgramDefinition XML contains container attributes and child milestone elements:

Declarative XML and Package Manifest Examples#

Below is a declarative XML definition of a sales onboarding program:

<?xml version="1.0" encoding="UTF-8"?>
<EnablementProgramDefinition xmlns="http://soap.sforce.com/2006/04/metadata">
    <description>Ramp new Sales Development Reps within 30 days.</description>
    <masterLabel>SDR 30-Day Onboarding</masterLabel>
    <programCategory>Onboarding</programCategory>
    <status>Draft</status>
</EnablementProgramDefinition>

Manifest Definition (package.xml)#

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types>
        <members>SDR_Onboarding_Program</members>
        <name>EnablementProgramDefinition</name>
    </types>
    <types>
        <members>Deals_Closed_Measure</members>
        <name>EnablementMeasureDefinition</name>
    </types>
    <version>68.0</version>
</Package>

CLI Retrieval and Deployment Commands#

Retrieve and deploy with sf CLI commands:

# Retrieve program definition
sf project retrieve start --metadata EnablementProgramDefinition:SDR_Onboarding_Program

# Deploy program alongside related measures
sf project deploy start --metadata EnablementProgramDefinition:SDR_Onboarding_Program EnablementMeasureDefinition:*

Architect Best Practices and Gotchas#

• Deploy as Draft First: Deploy new or modified program definitions in Draft status first. Once validated in the target environment, activate the program either manually or via a separate release script.
• Dependency Staging: Ensure all underlying EnablementMeasureDefinition and task category components are included in the same deployment bundle to avoid metadata resolution failures.
• Sandbox Testing: Populate mock Opportunities and Tasks in sandbox environments to verify that milestones register completion automatically before assigning users in production.

Frequently asked questions

What does EnablementProgramDefinition represent in Salesforce?

It represents a complete sales enablement curriculum, bundling milestones, learning exercises, and automated measure definitions into a structured program.

What must be deployed before deploying an EnablementProgramDefinition?

Deploy all referenced EnablementMeasureDefinition and EnblProgramTaskSubCategory records first, because the program definition directly references them.

Can an active EnablementProgramDefinition be modified directly in production?

Modifying active programs directly is restricted to protect assigned learners. Inactivate the program or deploy a new program version via your CI/CD pipeline.