> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/harness-platform/use-harness-platform/pipelines/add-note-during-pipeline-execution.md).

# Add Notes for Pipeline Execution

This feature allows users to add notes for pipeline execution.

Harness makes pipeline executions easier to understand and find. Add notes to any execution, such as ticket IDs, change requests, or deployment details, and search for executions using those notes.

This helps you capture the context behind every execution and quickly find the runs you need with the new Execution Notes filter.

***

## What you will learn from this topic

* How to [add notes](#add-a-note-to-a-pipeline-execution) to pipeline executions while they run or after they complete.
* How to [edit notes](#edit-the-note-to-a-pipeline-execution) on existing executions.
* How to [filter executions by notes](#filter-executions-by-notes) to find specific runs.

***

## Before you begin

* **Harness account access:** You need access to a Harness account with pipelines. Go to [Getting started with Harness Platform](/harness-platform/new-to-harness-platform/get-started.md) to create an account.
* **Pipeline execution permissions:** You need **Execute** permission on [Pipelines](/harness-platform/use-harness-platform/platform-access-control/permissions-reference.md#pipelines) to add or edit notes on pipeline executions. To get this permission, an administrator must assign you a role that includes it. Go to [RBAC in Harness](/harness-platform/use-harness-platform/platform-access-control.md) to understand role-based access control and [Manage roles](/harness-platform/use-harness-platform/platform-access-control/add-manage-roles.md) to configure role assignments.

***

## Add a note to a pipeline execution

You can add a note to a pipeline execution while it is running and even after the execution is completed.

In order to add notes for a pipeline after it has completed execution, navigate to the Execution List ( history ) and click on the three dot menu next to the execution for which you want to add notes and select **Add Execution Notes**.

Alternatively, select an execution and click **Add a Note** in the pipeline studio.

***

## Edit the note to a pipeline execution

You can update an existing note on a pipeline execution while it is running or after it has completed.

To edit a note:

1. Go to Execution History and open the execution you want to update.
2. In Pipeline Studio, click **View Note**.
3. Update the note as needed and save your changes.

***

## Filter executions by notes

You can create filters based on text present in execution notes and search across executions using these filters.

{% hint style="info" %}
This feature requires the `CDS_EXECUTION_LIST_FILTERS` feature flag. Contact [Harness Support](mailto:support@harness.io) to enable it.
{% endhint %}

In the [Add a note to a pipeline execution](#add-a-note-to-a-pipeline-execution) example, notes were added indicating whether the executed pipeline contained a single stage or multiple stages. This demonstrates how execution notes can be utilized. You can use any criteria such as ticket number, change request number, deployment details, pipeline changes, or any other criteria as per your requirements to filter execution notes.

The following example shows filtering based on execution notes across multiple runs of a pipeline, where some executions include a single stage while others include two or three stages.

* Using the keyword `single`
* Using the keyword `two`
* Using combination of keywords `single` , `two` and `three`

***

## Next steps

* [View and compare pipeline executions](/harness-platform/use-harness-platform/pipelines/executions-and-logs/view-and-compare-pipeline-executions.md): View compiled YAML and compare execution differences.
* [Executions management](/harness-platform/use-harness-platform/pipelines/executions-and-logs/executions-management.md): Manage queued and running executions across your account.
* [Add tags dynamically to execution](/harness-platform/use-harness-platform/pipelines/add-tags-dynamically-to-execution.md): Tag pipeline executions for better organization.

{% @harness-feedback/feedback module="harness-ai" pagePath="harness-ai/use-harness-platform/pipelines/add-note-during-pipeline-execution" %}