> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chkk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Steps

> A brief description, use-case, and usage instructions of the Add/Edit/Delete Custom Steps feature

Chkk's **Add/Edit/Delete Custom Steps** feature lets users embed their organization's internal processes into any Upgrade Assessment, Upgrade Template, or Upgrade Plan. This ensures every upgrade—across one or multiple clusters—follows the same best practices, compliance checks, and change-management guidelines. Because these custom steps carry forward from the template to each new Upgrade Plan, your team can delegate tasks in parallel without recreating instructions. Plus, you can still tailor steps for specific clusters even after a plan is instantiated, making it easy to address unique requirements.

This flexible capability fosters the reuse of best practices, retains institutional knowledge, and standardizes workflows—allowing teams to align quickly on operational details and speed up upgrades across the environment.

## Usage

<Note>
  The provided steps also apply to Upgrade Assessments, Cluster Upgrade Plans, Project Upgrade Templates,
  and Project Upgrade Plans.
</Note>

Below are the instructions for **adding, editing, and deleting custom steps** in an Upgrade Template.

<Steps>
  <Step title="Navigate to Cluster Upgrade Templates">
    1. In the **Chkk Dashboard**, expand **Upgrade Copilot** on the left menu.
    2. Click **Upgrade Templates** and then **Clusters**.
    3. You will see a list of all existing **Cluster Upgrade Templates**.
           <img src="https://mintcdn.com/chkk/ErQAF5e5P7IkmW9z/images/features/add-edit-remove-custom-steps-navigation.png?fit=max&auto=format&n=ErQAF5e5P7IkmW9z&q=85&s=a7c582c94a94ef1100a6374334993fbe" alt="Navigate to Upgrade Copilot" width="1915" height="998" data-path="images/features/add-edit-remove-custom-steps-navigation.png" />
  </Step>

  <Step title="Add a Custom Step">
    1. Select the desired **Cluster Upgrade Template**.
    2. Select the **three dots** icon on the right of any step to either **Add a step Before** or **Add a step After** the currently selected step.\\
           <img src="https://mintcdn.com/chkk/ErQAF5e5P7IkmW9z/images/features/add-custom-step-option.png?fit=max&auto=format&n=ErQAF5e5P7IkmW9z&q=85&s=f911619d2e0fb148536f37efdae87315" alt="Add a Custom Step" width="2980" height="1780" data-path="images/features/add-custom-step-option.png" />
    3. A **modal** will appear where you can fill in:
       * **Title**: The name of the custom step.
       * **Badge**: A tag or label displayed next to the step.
       * **Required**: Checkbox to mark the step as **required** or **optional**.
       * **Write/Preview**: Use the Markdown editor and preview window to craft the step's content.\\
             <img src="https://mintcdn.com/chkk/ErQAF5e5P7IkmW9z/images/features/add-custom-step-modal.png?fit=max&auto=format&n=ErQAF5e5P7IkmW9z&q=85&s=f12d415fc6a816b27278688814dae664" alt="Add a Custom Step Modal" width="2976" height="1780" data-path="images/features/add-custom-step-modal.png" />
    4. Click **Add Step** to confirm and insert the new custom step into the current stage.
           <img src="https://mintcdn.com/chkk/ErQAF5e5P7IkmW9z/images/features/custom-step-added.png?fit=max&auto=format&n=ErQAF5e5P7IkmW9z&q=85&s=9c379792af33156ff4f923b30947d564" alt="Custom Step Added" width="2572" height="1568" data-path="images/features/custom-step-added.png" />
  </Step>

  <Step title="Edit a Custom Step">
    1. Click the **three dots** icon on the right of the custom step you wish to modify.
       * Select **Edit Step** from the dropdown.\\
             <img src="https://mintcdn.com/chkk/ErQAF5e5P7IkmW9z/images/features/edit-custom-step-option.png?fit=max&auto=format&n=ErQAF5e5P7IkmW9z&q=85&s=1cbf22c4b2964e639365598ac519be2a" alt="Edit Custom Step Option" width="2574" height="1564" data-path="images/features/edit-custom-step-option.png" />
    2. A modal appears with the current details of the step (title, badge, etc.).
    3. Make the necessary changes and click **Update Step** to save your edits.\\
           <img src="https://mintcdn.com/chkk/ErQAF5e5P7IkmW9z/images/features/custom-step-edited.png?fit=max&auto=format&n=ErQAF5e5P7IkmW9z&q=85&s=2440edbbd201b4f6f30517b3eea303f5" alt="Custom Step Edited" width="2572" height="1566" data-path="images/features/custom-step-edited.png" />
  </Step>

  <Step title="Delete a Custom Step">
    1. Click the **three dots** icon on the right of the custom step you want to remove.
       * Select **Delete Step** from the dropdown.\\
             <img src="https://mintcdn.com/chkk/ErQAF5e5P7IkmW9z/images/features/delete-custom-step-option.png?fit=max&auto=format&n=ErQAF5e5P7IkmW9z&q=85&s=291a9eff0421b7a39ced97a0f3b32b5c" alt="Delete Custom Step Option" width="2574" height="1566" data-path="images/features/delete-custom-step-option.png" />
    2. A confirmation modal will prompt you to confirm the deletion.
    3. Click **Delete Step** to permanently remove the custom step from the selected stage.
  </Step>
</Steps>
