How Versioning Works

ShipRules AI automatically saves a snapshot of your entire shipping configuration every time you make a change. This gives you a complete history of what changed, when, and why.

Automatic snapshots

Every time you:

Create, update, or delete a rule
Create, update, or delete a shipping method
Create, update, or delete a product group
Promote staged changes from shadow mode
Use the AI prompt box to make changes

…a new version snapshot is saved. No manual “save” button needed.

What’s in a snapshot

A version snapshot contains your complete shipping configuration at that point in time:

All zones and subzones
All product groups and their variant assignments
All shipping methods with their rate configurations
All rules and conditions
All blended rates and preferences

Version metadata

Each version records:

Timestamp — when the change was made
Created by — who or what made the change (user, ai, import, rollback, promotion)
Description — a human-readable summary of what changed
Diff — a summary of what was added, modified, or removed compared to the previous version
Batch ID — if the change was part of a multi-step AI prompt, all operations share the same batch ID

Batched versions

When the AI prompt box creates multiple operations at once (e.g., “Free shipping over $100 and $5 surcharge for Alaska”), each operation creates its own version, but they’re grouped under a single batch.

In the version history, batched changes appear as a single entry that you can expand to see the individual operations. Rolling back a batch reverts all operations in the batch.

Retention

Plan	Version History
Starter	7 days
Pro	90 days
Enterprise	365 days

Versions older than your plan’s retention period are automatically cleaned up. The cleanup only removes the historical snapshots — your current live configuration is never affected.