Many Salesforce developers and admins have counted on Copado Essentials to quickly and reliably deploy changes from one Salesforce org to another. As teams grow in size and complexity, it is imperative for teams to go beyond org-to-org deployments and start thinking about how to formulate a consistent release process with good control and governance in place. This is what Work Items was built for.

A Work Item is an encapsulation of a user story and its progression through a consistent change management process with approval, history, visibility and collaboration built-in.

Turning On Work Items

Work items is not currently enabled by default and will need to be turned on by the Team Owner of your account. If you're the only person on your Copado Essentials team, you are the owner. If you aren't assigned the Owner role on your team, please ask the Owner with permissions to activate it for you. To activate this feature go to your Account Settings. Under Settings visit the Team section and check "Enable Work Items".


The Work Items feature requires Essentials+ licenses. However, you can enable Work Item at anytime without an Essentials+ license for a trial period of 3 weeks. After the trial period ends, you would need to subscribe to an Essentials+ license in order to continuing using Work Items.

Getting Started

Setting Up Pipeline

To get started, sign in Copado Essentials as a user with the team owner role. Navigate to Account > Team > Pipelines > Add Pipeline.

  • For each environment, enter the environment name and associate a Salesforce org with that environment.

  • After the pipeline is saved, it will be visible to all members within the team. However, before other members can use the pipeline, the owners of the associated Salesforce orgs in the pipeline must share org access to other team members.

Enable version history tracking (optional)

With our recent release of Work Items, you can now enable version history tracking for your pipelines.

For pipelines that have version history tracking enabled, Copado Essentials automatically commits any deployed metadata changes to the configured git branch as soon as your work item is deployed successfully to the corresponding environment.

To enable version history for a pipeline, simply edit the pipeline, select the backing git org and a corresponding branch for each environment, as below.

Create Work Items

Any member of the team can create work items. To create a work item, navigate to Work Items > New Work Item

  • Users are only required to enter the “Issue” field.

  • “Pipeline” field is automatically populated with the default pipeline configured by the team owner.

  • “Start from” environment is automatically populated based on the pipeline setting but users can choose to change the “Start from” environment.

Deploy Work Items

  • Users can perform various actions with work items including compare changes, add components, share deployment, comment on deployment, etc.

  • On successful deployment of a stage, the work item automatically progresses to the next stage.

  • If version history tracking is enabled for the pipeline, Copado Essentials automatically commits any deployed metadata changes to the corresponding git branch. You can view detail of the commit/history by clicking on the git branching icon next to each environment.

  • Optionally, users can go back to a previous stage if needed by clicking on More > Go Back to Previous Stage.

  • Permission levels (validate, deploy, view, manage) are applied at each stage of the pipeline based on the org sharing configuration.

  • Upon successful deployment of the final stage, the work item is considered complete and closed.

Did this answer your question?