Add Components to a Branch

Use the Add Components option to bring metadata components from a Salesforce connection into your branch for development and commits.

When a branch is first created, its Components tab contains metadata inherited from the Main Branch or whichever source branch was used during creation. You can add more metadata at any time using the Add Components button.

Steps to Add Components

1. In the branch view, go to the Components tab.

2. Click Add Components (top-right).

3. Select a Connection – choose the Salesforce org you want to retrieve metadata from.

4. Select Components – browse or search the metadata list, then mark the ones you want to include.

5. Give commit a message and click Commit to add them to the branch.

Activities Tracking

Once committed, you are redirected to the Activities tab, where two jobs are logged:

• Commit To Branch – confirms the components were added.

• Search Conflicts – checks for conflicts with existing branch metadata.

Result

The newly added metadata components will appear in the Components tab under the branch, alongside any inherited components.

Best Practices

• Always add components from the correct Salesforce org to avoid mismatches.

• Review Activities for conflicts before proceeding with pull requests or merges.

• Keep commit messages meaningful to track why specific components were added.