Every transaction policy change requires approval from the Admin Quorum. Before approving, reviewers need to see exactly what changed. The Policy Diff shows a clear, per-rule and per-condition breakdown of the differences between the current active policy and the pending draft under review, so you can verify intent and approve with confidence — without manually comparing the two versions.
The diff appears whenever there is a pending policy draft awaiting approval — after an admin edits the policy and clicks Send for review. See Edit transaction policy for the full editing and approval workflow.
Only admins can view policy diffs.
You can review the diff on:
- Web: During the edit
- Mobile: When the Admin Quorum receives the approval request on their mobile devices.
The mobile and web experiences provide the same level of detail — you don't lose any information by reviewing on either.
The policy diff compares the currently active policy against the pending draft. It does not compare against older historical versions.
The diff works at two levels: it first tells you which rules changed, and then lets you drill into what conditions changed inside each rule.
Only rules that actually changed are shown. Each changed rule is labeled with one of the following:
| Change type | Meaning |
|---|---|
| New | A rule that was added in the pending draft |
| Edited | An existing rule whose conditions or action were modified |
| Deleted | A rule that was removed in the pending draft |
For edited rules, the diff also identifies which conditions changed, so you can see at a glance what to inspect.
A rule's Action (Allow, Block, or Require Approval) is shown as a change only if it actually changed. If you edited a rule's recipients but left its action untouched, the action is not flagged as a difference.
The diff is based on the semantic content of each rule, not its raw representation. Cosmetic changes that don't affect policy behavior — such as reordering items within a single rule's condition — are not exposed as changes.
Expand any edited rule to see a diff for each changed condition. Unchanged conditions are not shown, so the review stays focused on what's different.
List-based conditions show the specific items that were added and removed, so you never have to spot the difference between two long lists yourself. This applies to:
- Recipient
- Initiator
- Origin
- Transaction Type
- Asset
- ABI
- Cosmos Message
- EVM Typed Message
Numeric and range-based conditions shows how the previous value changed to the new value, with the direction of the change (increase or decrease) made clear. This applies to:
- Transaction Amount
- Periodic Amount
When reviewing a pending draft, you can:
- See the rule-level change classification — which rules are New, Edited, or Deleted.
- Expand any rule to see the granular, per-condition diff described above.
Diffs are visible before you can approve, so you always review the changes before signing off.
You can also click Published in the upper-right corner of the Transaction Policy screen to compare the proposed version with the currently published version. See Edit, duplicate, delete, or reorder policy rules.
When the Admin Quorum receives an approval request, the mobile app shows a focused summary:
- Only rules that changed are listed.
- Each rule shows its change type: New, Edited, or Deleted.
- Edited rules may list the names of the changed conditions.
Open a single rule to toggle between two views:
- New policy state: The full updated rule, exactly as it will look once approved. To reduce noise, conditions that are hidden by default in the policy builder (Asset, Amount, ABI, Typed Message, Cosmos Message) are not shown when they are set to their default values.
- Diff: Only the changed conditions: added or removed items for list conditions, and old value vs. new value for numeric conditions.
Learn more: