> 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

Give MESA workflows and individual steps clear titles and descriptions so teammates, and your future self, can tell at a glance what each automation does.

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://docs.getmesa.com/assets/image%20%28614%29.png" 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://docs.getmesa.com/assets/image%20%28615%29.png" 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://docs.getmesa.com/assets/image%20%28616%29.png" 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://docs.getmesa.com/assets/image%20%28617%29.png" 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://docs.getmesa.com/assets/image%20%28618%29.png" 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://docs.getmesa.com/assets/image%20%28619%29.png" alt="Screenshot of the Settings section within a workflow step in MESA. Spotlight the Description box and the Save button."><figcaption></figcaption></figure>
