Skip to main content

Create a New Work Item

Create a Work Item to start a new piece of Salesforce work with its branch and environment set up for you.

Try it in Serpent

A Work Item is a new piece of work in a project. Serpent sets up the underlying Git branch for you, so you can focus on the Salesforce changes rather than the mechanics. New to these terms? Start with How Serpent Works: Key Concepts.

Before you start: the project's source control must already be connected, because that is where the Work Item's branch is created. You set this up when you create the project, or later under Project Settings > Source Control.

New Work Item form with type, name, assignee, and a require-review toggle

Create it in Serpent

Open the New Work Item form with the "Try it in Serpent" button above, then:

  1. Pick the type

    Click Type and choose Task or Bug, depending on the work.

  2. Name the Work Item

    Enter a Work Item Name that describes the change, so the branch is easy to recognise later.

  3. Assign an owner

    Choose who the Work Item is Assigned To.

  4. Create it

    Click Create Work Item. Serpent sets up the Git branch and opens the new Work Item, ready for your changes.

What to expect

Serpent creates the branch the moment you click Create Work Item, then opens the Work Item on its Build stage. If no branch is created, source control is not connected for the project: connect it under Project Settings > Source Control, then create the Work Item again. See No branch was created for my Work Item if it still does not appear.

Then add your changes

  • Pull in the Salesforce metadata you are changing.
  • Keep iterating until the change is ready for review.
  • Hand the Work Item off for review when it is complete.