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

# Editing rules

> Modify existing policy rules and update approval requirements.

You can edit existing rules to change conditions, adjust approval requirements, or update thresholds as your organization's needs evolve.

## When to edit rules

Consider editing rules when:

* **Business needs change** — You handle larger or smaller transactions
* **Organization grows** — You hire more approvers or change roles
* **Thresholds need adjustment** — Amount limits are too high or low
* **Rules aren't working** — A rule is creating bottlenecks or isn't specific enough
* **Compliance changes** — New regulatory requirements necessitate policy changes

## Edit a rule

<Steps>
  <Step title="Open policy">
    Go to **Settings** > **Policies** > **Vault policy** or **Admin policy**.
  </Step>

  <Step title="View all rules">
    You'll see a list of all active rules. Rules are shown in priority order (most specific first).

    <Frame caption="Rules list with edit options">
      <img src="https://mintcdn.com/deployment-4/lSVGGJ7Z6F9zIy7U/knowledge-base/images/screenshots/porto-policy-baseline.png?fit=max&auto=format&n=lSVGGJ7Z6F9zIy7U&q=85&s=36d0f0d8dbcb285a96847183fd5f1b28" alt="Vault policy rules screen showing existing rules in priority order" style={{ maxWidth: "280px", height: "auto" }} width="828" height="1792" data-path="knowledge-base/images/screenshots/porto-policy-baseline.png" />
    </Frame>
  </Step>

  <Step title="Select the rule to edit">
    Tap the rule you want to modify.
  </Step>

  <Step title="Tap edit">
    Select **Edit rule** or the **pencil** icon.
  </Step>

  <Step title="Change conditions">
    Modify any conditions:

    * Operation type
    * Amount thresholds
    * Address types
    * Time windows
    * Initiator roles
  </Step>

  <Step title="Change approval requirements">
    Update:

    * Number of approvers
    * Which approvers (specific people or roles)
    * Voting structure
    * Approval timeout

    <Frame caption="Changing quorum members for a rule">
      <img src="https://mintcdn.com/deployment-4/lSVGGJ7Z6F9zIy7U/knowledge-base/images/screenshots/porto-policy-quorum-members-1.png?fit=max&auto=format&n=lSVGGJ7Z6F9zIy7U&q=85&s=ac37537ea5e06dad51d866411b0954c1" alt="Rule editor showing quorum member selection interface" style={{ maxWidth: "280px", height: "auto" }} width="828" height="1792" data-path="knowledge-base/images/screenshots/porto-policy-quorum-members-1.png" />
    </Frame>
  </Step>

  <Step title="Save changes">
    Tap **Save** or **Update rule**.
  </Step>

  <Step title="Submit policy changes">
    Tap **Submit policy** or **Apply changes**. Modified rules take effect.
  </Step>

  <Step title="Approve if required">
    If your policy requires approval for policy changes, the edit must be approved.
  </Step>
</Steps>

## Common edits

### Adjust amount thresholds

If your transaction volume increases, you might adjust thresholds upward:

**Before:**

* Up to \$50,000: 1 approver
* $50,001 - $200,000: 2 approvers
* Over \$200,000: 3 approvers

**After:**

* Up to \$100,000: 1 approver
* $100,001 - $500,000: 2 approvers
* Over \$500,000: 3 approvers

Edit each rule to update the amount condition.

### Change approver requirements

If you add new approvers, you can adjust requirements:

**Before:** 2 of 2 (CEO + CFO) must approve large withdrawals

**After:** 2 of 3 (CEO, CFO, or COO)

Edit the rule to change the approver list and count.

### Make rules stricter

If security incidents increase approval requirements:

**Before:** 1 approver for deposits

**After:** 1 approver for deposits under $100k; 2 approvers for $100k+

Split the rule into two rules or add amount condition to existing rule.

### Make rules faster

If approvals are too slow, reduce requirements:

**Before:** 3 of 3 admins must approve transfers

**After:** 2 of 3 admins must approve transfers

Edit the rule to reduce from 3 to 2 approvers.

## Rule priority after editing

When you edit a rule that changes its specificity, rule priority may shift. For example:

**Original rule:** "Withdrawals > \$100k to new address" = 2 approvers

**After edit:** "Withdrawals > \$100k" = 1 approver (removed address condition)

Now the rule is less specific. If another rule says "Withdrawals to new address" = 2 approvers, that rule becomes more specific and takes priority for withdrawals over \$100k to new addresses.

**Solution:** Review all rules after editing one to ensure priority is what you intend.

## Editing without disruption

To edit a rule while minimizing disruption:

1. **Review affected operations** — See what operations the current rule applies to
2. **Create new rule** — Add a new rule with desired conditions
3. **Test the new rule** — Verify it works as expected
4. **Deactivate old rule** — Remove the old rule once new rule is working
5. **Audit trail** — The change is recorded showing old and new rules

## Before/after rule changes

Document the change:

| Rule              | Before           | After            | Effective date |
| :---------------- | :--------------- | :--------------- | :------------- |
| Large withdrawals | 3 of 3 approvals | 2 of 3 approvals | Jan 15, 2026   |

Keep this record for compliance and future reference.

## Approval of rule changes

Rule edits themselves require approval:

* **Who approves:** Typically the same policy that governs vault operations
* **Timing:** Rule changes must be approved before taking effect
* **Notice:** Users should be notified of upcoming rule changes

## Testing rule changes

Before finalizing edits:

1. **Simulate operations** — Review how the new rule would apply to recent transactions
2. **Check for conflicts** — Ensure the edited rule doesn't conflict with other rules
3. **Verify priority** — Confirm the rule applies in the right order relative to other rules
4. **Calculate impact** — How many operations will be affected? Will approvals speed up or slow down?

## Rolling back edits

If an edited rule causes problems:

1. **Revert to previous version** — Many systems allow rolling back recent changes
2. **Create new rule** — Alternatively, create a new rule and deactivate the problematic one
3. **Notify users** — Let them know the rule has changed
4. **Document reason** — Record why the change was reverted

## Preventing rule conflicts

When editing rules, watch for conflicts:

**Conflict example:**

* Rule A (before edit): "Withdrawals > \$100k" = 2 approvers
* Rule B: "Withdrawals to trusted destinations" = 1 approver
* Edit Rule A to: "Withdrawals to new addresses" = 3 approvers

**Result:** For withdrawal >\$100k to new address, which rule applies?

* Rule A applies (more specific: amount + address + new)
* This is correct — highest specificity wins

**Solution:** Review rule priority after edits to ensure most specific rules still win.

## Communicating rule changes

When you edit rules, notify affected users:

1. **What changed** — Be specific about which rules were modified
2. **Why it changed** — Explain the business reason
3. **Effective date** — When does the new rule take effect?
4. **Impact** — How will this affect operations? Will approvals be faster/slower?
5. **Examples** — Provide examples of how operations are affected

## Audit trail of edits

All rule edits are recorded:

* **Who changed it** — The user who made the edit
* **When** — The exact time and date
* **What changed** — Detailed diff of conditions and requirements
* **Approval** — Who approved the rule change

Review the audit trail to understand rule evolution over time.

## Rule maintenance schedule

Establish a regular maintenance schedule:

* **Quarterly:** Review rules to ensure they still align with business needs
* **After incidents:** Review rules if security issues occur
* **After org changes:** Update rules when team structure or approvers change
* **After business changes:** Adjust thresholds if transaction volume changes significantly

See [Managing rules](/knowledge-base/porto/policies/managing-rules) for comprehensive rule maintenance.
