> For the complete documentation index, see [llms.txt](https://docs.docontrol.io/docontrol-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docontrol.io/docontrol-user-guide/workflows/workflow-dashboard.md).

# Workflow dashboard

You can view all your workflows from a single page that displays both the [workflow analytics](#workflow-analytics) dashboard for the last 30 days, and a [list of all your workflows](#manage-workflows).

[Manage your workflows](#manage-workflows) with a variety of actions to filter, edit, activate, deactivate, duplicate, export and delete workflows.

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FOu9Bsfw0XM3D9cfiEWBi%2FWF%20dashboard.gif?alt=media&amp;token=5c8066c0-160e-4dcb-9caa-631e0f1db3cf" alt=""><figcaption><p>The workflow dashboard displays all workflow activity and analytics across your organization</p></figcaption></figure>

{% hint style="success" %}
To display the Workflow dashboard, click **Workflows** in the DoControl menu bar. Scroll down to view the Workflow list.
{% endhint %}

## Workflow analytics

The Workflow analytics dashboard gives you a high-level view of your workflow analytics, and includes graphic highlights of your workflow activity from the last 30 days:

### Monthly executions

The total number of workflow executions that ran in the last 30 days, with the percentage of workflows that increased or decreased compared to the previous month.

* **Data scans** - Total number of PII and regex scans that ran in the last 30 days
* **Interactions** - Total number of user responses to approval or decision requests in the last 30 days
* **Remediations** - Total number of successfully completed remediation actions in the last 30 days

<div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FSxNzhUUEFqIdTNBAa2gB%2FWF%20monthly%20execs.png?alt=media&amp;token=38c41601-acc7-4f93-b95b-b3e024740864" alt=""><figcaption></figcaption></figure></div>

### **Workflow activity**

A line graph of workflow status (Completed, In progress, Warning, or Failed) by date for all workflow executions over the last 30 days.

Hover over the graph to view the number of workflow executions per workflow status on a specific date.

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FE5ossgEAbSU56DxNsiwz%2FWF%20workflow%20activity.png?alt=media&amp;token=7387ba9c-b656-47c0-9c53-142ab191391e" alt=""><figcaption></figcaption></figure>

### **Workflow type**

A doughnut graph of the origin of your workflows (alert, inventory action, event-based or scheduled), as well as the number of aggregated workflows, and the number of workflows according to mode (active or inactive).&#x20;

Hover over the graph to view the number of workflows per type.

<div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FE1g3jh50XijToglgFYte%2FWF%20workflow%20type.png?alt=media&amp;token=b31ea188-3f0a-4f1e-b33b-3120d28e226a" alt=""><figcaption></figcaption></figure></div>

### **Top workflows**

A line graph of your organization's most popular workflows that were executed in the last 30 days.

Hover over the graph to view the number of executions that were run for a specific workflow on a specific date and time.

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FUSGlXIF5roJIpUEGh77O%2FWF%20top%20workflows.png?alt=media&amp;token=c25aa301-60ed-4589-89a1-56c3a1056a3b" alt=""><figcaption></figcaption></figure>

## Manage workflows

The Workflow list displays a summary of your organization's workflows with main highlights, including execution activity over the last 30 days:

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FpXNLc1CO5R6toyesT3oy%2Fworkflow%20list%20no%20callout.png?alt=media&amp;token=26b746ae-8a03-4427-a24b-e37f26b8aaab" alt=""><figcaption><p>The workflow list highlights data for all the workflows created in your organization</p></figcaption></figure>

<table><thead><tr><th width="251">Workflow list parameter</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Workflow name, who created the workflow and when</td></tr><tr><td>Number of executions</td><td>Total number of executions in the current month.<br>The maximum limit is 10,000 executions a month. </td></tr><tr><td>Aggregated</td><td>Indicates that the workflow was triggered by multiple events</td></tr><tr><td>Preview</td><td>Click to view a mini-graphic of the workflow</td></tr><tr><td>App</td><td>SaaS application from where the trigger event originated</td></tr><tr><td>Trigger event</td><td>A single SaaS event or multiple events that set the workflow into motion</td></tr><tr><td>Mode</td><td><ul><li><strong>Active</strong> - The workflow will be executed each time a triggering event occurs.</li><li><strong>Inactive</strong> - The default mode of a workflow. An inactive workflow is not executed. </li></ul></td></tr><tr><td>Execution activity</td><td><p>An interactive line graph displaying workflow activity over the last 30 days, total number of executions, and number of executions according to status. </p><p>Click <strong>View all</strong> to display all workflow execution details.</p></td></tr><tr><td>More</td><td><p>Click the <strong>Ellipsis</strong> <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FgRWgKsPpr1P3kYK5t6s9%2Fellipsis.png?alt=media&amp;token=9a356ebe-c05f-46c0-8cec-0c2cd7c1ea50" alt="" data-size="line"> icon to display more workflow actions:</p><ul><li><a href="#edit-workflows">Edit</a></li><li><a href="#activate-or-deactivate-workflows">Activate or Deactivate</a></li><li><a href="#duplicate-workflows">Duplicate</a></li><li><a href="#export-workflows">Export</a></li><li><a href="#delete-workflows">Delete</a></li></ul></td></tr></tbody></table>

### Filter workflows

To narrow down the number of workflows displayed in the Workflow list, you can filter all your organization's workflows according to these filters:

<table><thead><tr><th width="194">Filter option</th><th>Description</th></tr></thead><tbody><tr><td>App</td><td>The SaaS app from which the workflow was triggered - for example, Google Drive or Slack.</td></tr><tr><td>Mode</td><td>If the workflow is active or inactive</td></tr><tr><td>Type</td><td>Characteristic of the workflow: inventory action, alert, event-based, or aggregated.</td></tr><tr><td>Workflow status</td><td><p>Progress of the workflow's execution:</p><ul><li>In progress - wait</li><li>In progress - pending approval</li><li>In progress</li><li>Completed</li><li>Warning</li><li>Failed</li><li>Cancelled</li></ul></td></tr><tr><td>Search in current results</td><td>Enter text to search by the workflow name.</td></tr></tbody></table>

### Edit workflows

You can edit both active and inactive workflows.

1. In the DoControl navigation menu, click **Workflows.**
2. In the Workflow list, next to the relevant workflow click the **More** ![](https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FgRWgKsPpr1P3kYK5t6s9%2Fellipsis.png?alt=media\&token=9a356ebe-c05f-46c0-8cec-0c2cd7c1ea50) icon > **Edit**. \
   The workflow opens in the canvas.
3. Update any part of the [workflow settings](/docontrol-user-guide/workflows/define-workflow-settings.md): name and description, activation mode, trigger, or actions.&#x20;
4. Click **Save workflow**. After confirmation, the workflow is updated.
5. If you wish to save as a different workflow and keep both versions, click **Save as new workflow** and give it a new name.

### Activate workflows

The mode of a workflow indicates if it's being executed or not. To run a workflow, you need to change the workflow mode from inactive to **active**.&#x20;

Once activated, the workflow will be executed each time a triggering event occurs.

#### To activate a workflow:

1. In the DoControl navigation menu, click **Workflows.**
2. In the Workflow list, next to the relevant inactive workflow click the **More** ![](https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FgRWgKsPpr1P3kYK5t6s9%2Fellipsis.png?alt=media\&token=9a356ebe-c05f-46c0-8cec-0c2cd7c1ea50) icon.\
   ![](https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FFRiEEodfxbxrQPMqUsXT%2Fmore%20menu.png?alt=media\&token=0bfe9c13-4ae4-4b68-880f-9de333c33e22)
3. To run the inactive workflow, click **Activate.**
4. Alternatively, open the relevant workflow in the canvas and click **Active** to change the mode.<br>

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FoXDVWNIDis9217z2lBYr%2Factivate%20WF.png?alt=media&amp;token=72cd4b6d-19fa-435c-b2c5-6af8b8bb80a5" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
After the workflow is executed, you can view the execution activity by clicking **View all** next to the specific workflow. For more details, see [Monitor workflows](/docontrol-user-guide/workflows/activity-dashboard.md).
{% endhint %}

### Deactivate workflows

The mode of a workflow indicates if it's being executed or not. To run a workflow, you need to change the workflow mode from inactive to **active**.&#x20;

Once activated, the workflow will be executed each time a triggering event occurs.

#### To deactivate a workflow:

1. In the DoControl navigation menu, click **Workflows.**
2. In the Workflow list, next to the relevant active workflow click the **More** ![](https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FgRWgKsPpr1P3kYK5t6s9%2Fellipsis.png?alt=media\&token=9a356ebe-c05f-46c0-8cec-0c2cd7c1ea50) icon.\
   ![](https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FdSLG9F9FDLFxJMkL2Tx2%2Fdeactivate.png?alt=media\&token=9f1e0423-f044-42d9-ae4c-44eb59a9df37)
3. To disable the active workflow, click **Deactivate.**
4. Alternatively, open the relevant workflow in the canvas and click **Inactive** to change the mode.<br>

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F546MYTL1PMkFXlBidUVu%2Fdeactivate%20WF%20from%20list.png?alt=media&amp;token=7ab2128d-7790-4322-9045-9bb662462d82" alt=""><figcaption></figcaption></figure></div>
5. Select how to handle existing workflow executions:
   * Complete all executions first, OR&#x20;
   * Stop all executions in progress.<br>

     <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Fhip1oBZlG3rGTKf0ysKU%2Fdeactivate-stop.png?alt=media&amp;token=1117f26a-510c-44ea-b349-f8afc3c91ba4" alt=""><figcaption></figcaption></figure></div>
6. Click **Deactivate**.

### Duplicate workflows

You can copy an existing workflow by duplicating it.

1. In the DoControl navigation menu, click **Workflows.**
2. In the Workflow list, next to the relevant workflow click the **More** ![](https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FgRWgKsPpr1P3kYK5t6s9%2Fellipsis.png?alt=media\&token=9a356ebe-c05f-46c0-8cec-0c2cd7c1ea50) icon > **Duplicate**.&#x20;

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F2wBMwYC68KMaXDtk7b5b%2FDuplicate.png?alt=media&amp;token=54f60ab5-31c9-47e9-ad21-d752b6559439" alt="" width="375"><figcaption></figcaption></figure></div>
3. Enter a name for the new workflow.
4. Click **Duplicate**.

### Export workflows

You can export workflows for sharing with other users or with DoControl support. &#x20;

1. In the DoControl navigation menu, click **Workflows.**
2. In the Workflow list, next to the relevant workflow click the **More** ![](https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FgRWgKsPpr1P3kYK5t6s9%2Fellipsis.png?alt=media\&token=9a356ebe-c05f-46c0-8cec-0c2cd7c1ea50) icon > **Export**.&#x20;

The workflow is downloaded as a JSON file to your computer.&#x20;

### Delete workflows

When it's no longer needed, you can delete a workflow from the Workflow list.

1. In the DoControl navigation menu, click **Workflows.**
2. In the Workflow list, next to the relevant workflow click the **More** ![](https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FgRWgKsPpr1P3kYK5t6s9%2Fellipsis.png?alt=media\&token=9a356ebe-c05f-46c0-8cec-0c2cd7c1ea50) icon > **Delete**.&#x20;
3. Click **Delete** to confirm the deletion.<br>

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FDjLoQzjPJn1yafwlidXV%2FDelete%20workflow.png?alt=media&amp;token=c336a15b-2632-41c6-b59a-6ec2dfa6a3b5" alt="" width="525"><figcaption></figcaption></figure></div>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.docontrol.io/docontrol-user-guide/workflows/workflow-dashboard.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
