{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","admonition"]},"redocly_category":"User Guide","type":"markdown"},"seo":{"title":"Review Policy Changes"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"review-policy-changes","__idx":0},"children":["Review Policy Changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every transaction policy change requires approval from the"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/admin-quorum"},"children":["Admin Quorum"]},". Before approving, reviewers need to see"," ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/policy-diff-1.c5494f89447889c6b74a3cd218d3b5dfe765aa1d12bdcf0eb90d6f51aff236b0.9c1bb791.png","alt":"alt","framed":false,"withLightbox":false,"width":"700","border":"1px solid lightgray"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The diff appears whenever there is a pending policy draft awaiting approval —"," ","after an admin edits the policy and clicks ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Send for review"]},". See"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/policies/create-a-policy-rule"},"children":["Edit transaction policy"]}," for the full editing and"," ","approval workflow."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only admins can view policy diffs."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can review the diff on:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#review-a-diff-on-web"},"children":["Web"]},": During the edit"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#review-a-diff-on-mobile"},"children":["Mobile"]},": When the Admin Quorum receives the"," ","approval request on their mobile devices."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The mobile and web experiences provide the same level of detail — you don't lose"," ","any information by reviewing on either."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":""},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The policy diff compares the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["currently active policy"]}," against the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["pending draft"]},"."," ","It does not compare against older historical versions."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"diffs-for-rules-and-conditions","__idx":1},"children":["Diffs for rules and conditions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The diff works at two levels: it first tells you ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["which rules"]}," changed, and then"," ","lets you drill into ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["what conditions"]}," changed inside each rule."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rule-level-changes","__idx":2},"children":["Rule-level changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only rules that actually changed are shown. Each changed rule is labeled with"," ","one of the following:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Change type"},"children":["Change type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A rule that was added in the pending draft"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edited"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An existing rule whose conditions or action were modified"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deleted"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A rule that was removed in the pending draft"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["edited"]}," rules, the diff also identifies which conditions changed, so you"," ","can see at a glance what to inspect."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Action is only flagged when it changed"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A rule's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Action"]}," (Allow, Block, or Require Approval) is shown as a change"," ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Only effective changes are shown"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The diff is based on the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"condition-level-changes","__idx":3},"children":["Condition-level changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["List-based conditions"]}," show the specific items that were ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["added"]}," and"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["removed"]},", so you never have to spot the difference between two long lists"," ","yourself. This applies to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Recipient"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Initiator"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Origin"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Transaction Type"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Asset"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ABI"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cosmos Message"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["EVM Typed Message"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Transaction Amount"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Periodic Amount"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"review-a-diff-on-web","__idx":4},"children":["Review a diff on web"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When reviewing a pending draft, you can:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["rule-level change classification"]}," — which rules are New, Edited,"," ","or Deleted."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expand any rule"]}," to see the granular, per-condition diff described above."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Diffs are visible before you can approve, so you always review the changes"," ","before signing off."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Compare against the published policy"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Published"]}," in the upper-right corner of the Transaction"," ","Policy screen to compare the proposed version with the currently published"," ","version. See"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/policies/create-a-policy-rule#edit-duplicate-delete-or-reorder-policy-rules"},"children":["Edit, duplicate, delete, or reorder policy rules"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"review-a-diff-on-mobile","__idx":5},"children":["Review a diff on mobile"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the Admin Quorum receives an approval request, the mobile app shows a"," ","focused summary:"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/policy-diff-mobile.7e3d7e901e1c8983fc723810307d38da25e84174119f8568783988dc86db2132.9c1bb791.png","alt":"alt","framed":false,"withLightbox":false,"width":"250","border":"1px solid lightgray"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Only rules that ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["changed"]}," are listed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each rule shows its change type: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edited"]},", or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deleted"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Edited rules may list the names of the changed conditions."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open a single rule to toggle between two views:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Diff:"]}," Only the changed conditions: added or removed items for list"," ","conditions, and old value vs. new value for numeric conditions."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn more:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/policies/create-a-policy-rule"},"children":["Edit transaction policy"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/policies/policy-rules-conditions-and-actions"},"children":["Rule conditions and actions"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/policies/policy-explanation"},"children":["Understand policy decisions"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/admin-quorum"},"children":["Admin Quorum"]}]}]}]},"headings":[{"value":"Review Policy Changes","id":"review-policy-changes","depth":1},{"value":"Diffs for rules and conditions","id":"diffs-for-rules-and-conditions","depth":2},{"value":"Rule-level changes","id":"rule-level-changes","depth":3},{"value":"Condition-level changes","id":"condition-level-changes","depth":3},{"value":"Review a diff on web","id":"review-a-diff-on-web","depth":2},{"value":"Review a diff on mobile","id":"review-a-diff-on-mobile","depth":2}],"frontmatter":{"seo":{"title":"Review Policy Changes"}},"lastModified":"2026-08-09T15:00:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/policies/review-policy-changes","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}