# Configuring Lifecycle Stages

When moving a document or object record through a lifecycle, it can be hard to understand which steps are complete and which steps are still remaining. Lifecycle Stages allow organizations to group document and object lifecycle states into ordered collections of stages. Vault then visually represents a document or object record's current stage in the <a href="/en/gr/9753/">Doc Info</a>
 page and <a href="/en/gr/44069/#detail_page">object record detail page</a>
 through the Lifecycle Stages Chevron panel.

<div class="note-border alert-info">
  <div class="alert alert-info" role="alert">
    <div><i class="far fa-info-circle"></i></div>
    <div class="alert-text">
      <p><strong>Note</strong>: Admins should not configure workflows, entry criteria, or other business logic based on Lifecycle Stages, but should instead configure Lifecycle Stages to reflect business logic.</p>
    </div>
  </div>
</div>



## Accessing Lifecycle Stage Configurations

To view and edit lifecycle stage configurations, navigate to **Admin** > **Configuration** > **Lifecycle Stage Groups**.

## Configuration Overview

The following list is an overview of how to configure lifecycle stages:

* If the relevant lifecycles are not already configured, we recommend setting up both the lifecycle and the lifecycle states before you begin configuring lifecycle stages.
* **Create a new Lifecycle Stage Group**. For object lifecycles, each lifecycle stage group applies to a single object and object type. (If the object does not use object types, the lifecycle stage group applies to the base object type.) For documents, each lifecycle stage group applies to a single document lifecycle.
* **Create Stages** within the Lifecycle Stage Group. Click into each stage to define the specific lifecycle states that belong to the stage.
* **Reorder the stages** to reflect the process that an object record or document follows.
* Verify that the default <a href="/en/gr/2942/#types-of-field-level-security">field-level security</a>
 for the _Lifecycle Stage_ (`stage__sys`) and _Lifecycle State Stage ID_ (`state_stage_id__sys`) fields are not set to _Hidden_. If the default field-level security is _Hidden_ and there are no overrides to make these fields at least _Read Only_ to users, the lifecycle stages will not appear as expected.



<div class="note-border alert-info">
  <div class="alert alert-info" role="alert">
    <div><i class="far fa-info-circle"></i></div>
    <div class="alert-text">
      <p><strong>Note</strong>: Vault updates the <em>Lifecycle Stage</em> (<code class="language-plaintext highlighter-rouge">stage__sys</code>) and <em>Lifecycle State Stage ID</em> (<code class="language-plaintext highlighter-rouge">state_stage_id__sys</code>) fields on existing documents and object records when you configure lifecycle stages. Adding these fields to any <a href="/en/gr/26387/#fields">object page layout</a>
 may result in a <a href="/en/gr/40902/">Vault Compare difference</a>
.</p>
    </div>
  </div>
</div>



## How to Create Object Lifecycle Stage Groups

To create a new lifecycle stage group:

1. From the **Lifecycle Stage Groups** page, click **Create**.
2. Select **Object Stage Group** in the drop-down.
3. Enter a **Label** for the Lifecycle Stage Group. This only appears in the configuration screens to help Admins manage the various groups. It does not appear to users.
4. Select the related **Object Lifecycle**.
5. Select an **Object Type**.
6. Optional: Enter a **Description**. This only appears in the configuration screens to help Admins manage the various groups. It does not appear to users.
7. Click **Save**



<div class="note-border alert-info">
  <div class="alert alert-info" role="alert">
    <div><i class="far fa-info-circle"></i></div>
    <div class="alert-text">
      <p><strong>Note</strong>: The lifecycle stages chevron panel is not displayed on object records unless <a href="/en/gr/26387/#object-type-layout"><em>Show Lifecycle Stages</em></a>
 is enabled.</p>
    </div>
  </div>
</div>



## How to Create Document Lifecycle Stage Groups

To create a new lifecycle stage group:

1. From the **Lifecycle Stage Groups** page, click **Create**.
2. Select **Document Stage Group** in the drop-down.
3. Enter a **Label** for the lifecycle stage group. This only appears in the configuration screens to help Admins manage the various groups. It does not appear to users.
4. Select the related **Document Lifecycle**.
5. Optional: Enter a **Description**. This only appears in the configuration screens to help Admins manage the various groups. It does not appear to users.
6. Click **Save**.

## How to Create Stages

When using this feature, the stages are what appears for users on the Doc Info and object record details pages. To create stages within a document or object lifecycle stage group:

1. From the **Lifecycle Stage Groups** page, click into the specific lifecycle stage group.
2. Under **Stages**, click **Create**.
3. Enter a **Label** for the stage. This will display in the Lifecycle Stages Chevron Panel for users.
4. Optional: Enter a **Description** for the stage. This only appears in the configuration screens to help Admins manage the various stages. It does not appear to users.
5. Click **Save**.
6. From the list of stages, click into the new stage and click **Add** in the **States** section.
7. Optional: Change the stage's **Status** to **Active** or **Inactive**. Inactive stages with no associated states will not appear in the Doc Info page or object record detail pages.
8. A pop-up window displays available states in the related lifecycle. If a state is associated with another stage, it does not show here. Click the green plus (+) icon to associate a state with the current lifecycle stage. Click **OK** to close the window when done.

## How to Order Stages

The order of stages in the **Lifecycle Stage Group** page is the order that Vault displays in the Doc Info page or object record detail page. Changes to the order are effective immediately, although users who loaded a Doc Info page or object record detail page before the change will need to refresh.

To change the order of lifecycle stages:

1. From the **Lifecycle Stage Groups** page, click into the specific lifecycle stage group.
2. Under **Stages**, click **Reorder**.
3. Drag the triangle icons for each row to reorder.

Click **Save** when the order is correct.

## Related Permissions

|Type|Permission|Controls|
|--- |--- |--- |
|Security Profile|Objects: Object Lifecycle State-Stage: Read|Ability to view Object Lifecycle stages|
|Security Profile|Objects: Document Lifecycle State-Stage: Read|Ability to view Document Lifecycle stages|
|Security Profile|User: View User Information|Ability to view Lifecycle Stage Chevron panel|