Create substates for a team in EAP

task australia Updated Oct 14, 2026 1 min read create-substates-for-a-team-in-eap.md
Raw file servicenow.com

Add substates to a story state for an Agile Team to track work in more detail on stories and on the Planning board in Enterprise Agile Planning.

Before you begin

Role required: sn_apw_advanced.eap_scrum_master

About this task

Substates apply to one team at a time. For more information about how substates work, see Substates in EAP.

Procedure

  1. Navigate to Workspaces > Strategic Planning Workspace > Enterprise Agile Planning.

  2. From the Agile structure section of the left navigation panel, choose your Agile Team.

  3. In the page header, select Team settings.

  4. Select Substates.

    The tab lists the substates of the team, grouped by state and sorted by order.

    [Omitted image "eap-substates-tab.png"] Alt text: Substates tab listing a substate under each of the Ready and Work in progress states.

  5. Select New to create a substate.

  6. Fill in the substate fields.

    Field Description
    State Story state that the substate belongs to. This field is required.
    Name Label that users see for the substate. This field is required.
    Order Position of the substate within its state. Substates with lower numbers appear first. This field is required.
    Use as default Option to make the substate the default for its state. A state can have only one default substate. The first substate that you create for a state is set as the default even if you don't select this option. If another substate is already the default, it's replaced and a message tells you about the change.

    The Team field is read-only and is set to the team that you opened.

    [Omitted image "eap-substate-form.png"] Alt text: Substate form with the State, Name, Order, Team and Use as default fields.

  7. Select Save.

Result

The substate appears in the list under its state, in order. If it's the first default substate for the state, stories in that state that have no substate receive it. A message tells you that the update is running in the background.

Related topics

Substates in EAP

Set WIP limits for Kanban lanes in EAP

Keywords substatesTeam Settingsstory states
Search documentation
Search document titles and file paths on the australia branch