> For the complete documentation index, see [llms.txt](https://docs.getmesa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getmesa.com/best-practices/set-titles-and-descriptions.md).

# Set Titles & Descriptions

Context can be crucial if other members of your team are looking at workflows. The following title does not give many contexts to the function of the workflow.

## Workflow Titles

Within your workflow, there is an option to adjust the title of each step. This is oh so helpful at placing a clear and purposeful title to each step. Your future self will thank you for adding a descriptive title so you won't have to dig into the details later.

Let's fix it! Click the title of your workflow or the **Dashboard** to bring up the **Manage workflow** details options to make changes.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-e715430a0f0d8de280611b59dc8ef2a2b423ac36%2Fimage%20(614).png?alt=media" alt="Screenshot of a workflow in the MESA Dashboard. Spotlight the workflow title used to open the Manage workflow details."><figcaption></figcaption></figure>

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-f840d22eeff8f2a7076eca7aee2d60435746d3f5%2Fimage%20(615).png?alt=media" alt="Screenshot of the Manage workflow details options in MESA. Spotlight the workflow name field."><figcaption></figcaption></figure>

Enter your new workflow name and select **Save Changes.** Whoa, this is a much better title!

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-3771a1fff8e9f3311388f2b873cda1be78e401de%2Fimage%20(616).png?alt=media" alt="Screenshot of the Manage workflow details with a new workflow name entered. Spotlight the Save Changes button."><figcaption></figcaption></figure>

## Workflow Descriptions

But wait, you can add more context! You can adjust the description in the **Manage workflow** details of your workflow. While you're updating that workflow name, in the same box find the **Description** field. The text can describe the goal, the steps, or anything else that is helpful to note.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-2ed0fa1a00e968025cb8440fa39b824684910d27%2Fimage%20(617).png?alt=media" alt="Screenshot of the Manage workflow details in MESA. Spotlight the Description field."><figcaption></figcaption></figure>

Hit **Save Changes** and your new description will appear on the right-hand side of your workflow **Dashboard** page in the **Details** section.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-1e2dcedac6cf5b28d43f98b8966649233b0cc63b%2Fimage%20(618).png?alt=media" alt="Screenshot of the workflow Dashboard page after saving. Spotlight the Details section on the right-hand side showing the new description."><figcaption></figcaption></figure>

## Step Titles

Within your workflow, there is an option to adjust the title of each step. This is oh so helpful at placing a clear and purposeful title to each step. Your future self will thank you for adding a descriptive title so you won't have to dig into the details later.

To add a new step title description, select the **Settings** section within the step. Next, add your updated or new title in the **Description** box and **Save**. Bravo, you have a descriptive title for your step!

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-e3f397237700b439e7a3b6e3dbeb7b80e12b5c54%2Fimage%20(619).png?alt=media" alt="Screenshot of the Settings section within a workflow step in MESA. Spotlight the Description box and the Save button."><figcaption></figcaption></figure>
