---
title: "How to Use Rule Audit History"
slug: "use-rule-audit-history"
description: "This document shows how to create, set up, and view an Audit History Report for a Rule. Doing so will allow users the ability to view the history of a Rule in a Flow with information such as, the Rule Name and any changes to its name, as well as the Results from running the Rule."
tags: ["Rules", "auditing", "Reports "]
updated: 2025-06-17T19:09:10Z
published: 2025-06-17T19:09:10Z
canonical: "documentation.decisions.com/use-rule-audit-history"
---

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

# How to Use Rule Audit History

## Overview

[Rule](/v9/docs/about-rules) and [Truth Table](/v9/docs/about-truth-tables) data can be captured and stored within the rule_audit_history table and used by [Reports](/v9/docs/about-reports). The audit history will return data such as the execution results and the name of a particular Rule.

---

## Capture Audit History

To capture the audit history for a Rule, select the Rule in the **Flow Designer** and navigate to the **Properties** panel. Under **Audit,** select the checkbox for **Capture Audit History**.

When this checkbox is selected, three new inputs are added to the rule: **Rule Audit Folder ID, Rule Audit ID,** and **Rule Audit Name.** These inputs do not need to be defined to store data but can be used as filters for a Report.

| Inputs | Description |
| --- | --- |
| Rule Audit Folder ID | A String representing the Rule's Folder ID field used for report filtering. This can be defined as the Folder ID of the executing Flow. |
| Rule Audit ID | A String representing the Rule's ID field used for report filtering. This can be defined as the Rule's ID or a specific guid. |
| Rule Audit Name | A String representing the Rule's Name. |

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-17_14h57_46.png)

---

## Rule Audit History Report

Within the Report Designer, select **Add** under **Data Sources** and expand the **Infrastructure** section, then navigate to **Rule Audit History** in the list. This Report will show multiple **Data Fields** relating to the audit. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-17_15h03_58.png)

---

## Phrase Rule Audit differences

The **Phrase Rule Audit History** functions differently from Rule Audit History. The main difference is the Phrase Rule Audit History captures the anchor data and data values that were used in the Rule. **Phrase Rule Audit History** requires both **Capture Audit History** and **Capture Phrase Audit History** checked to record data.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/photoshop%20how%20to%20use%20rule%20audit%20history.jpg_2(1).jpg)

---

For further information on Rules, visit the [Decisions Forum](https://community.decisions.com/categories/Rules).