Comparisons
A comparison shows the diff between two metadata sources. Use comparisons to understand what has changed between environments, validate a backup, or prepare for a deployment.
Supported source combinations
| Source | Target | Use case |
|---|---|---|
| HubSpot portal | HubSpot portal | Sync dev → staging → prod |
| HubSpot portal | Git repository | Validate a backup is current |
| Git repository | HubSpot portal | Review drift since last backup |
| Git repository | Git repository | Compare snapshots over time |
Creating a comparison
- Go to Comparisons in the sidebar
- Click New Comparison
- Select a Source and a Target from your connected portals and repositories
- Give the comparison a name (optional but recommended)
- Click Create
The comparison is queued and processed asynchronously. Status updates in real time:
| Status | Meaning |
|---|---|
pending | Queued for processing |
in progress | Actively computing the diff |
completed | Diff is ready to view |
error | Processing failed |
Viewing the diff
Click View on a completed comparison to open the diff viewer. The viewer shows:
- Summary — counts of added, modified, and removed items by metadata type
- Structured diff — field-level changes for each item, displayed in a tree view
- Monaco diff editor — side-by-side raw JSON comparison for any item
Reading the diff
Changes are colour-coded:
- 🟢 Added — present in target, not in source
- 🔴 Removed — present in source, not in target
- 🟡 Modified — present in both, but values differ
Renaming a comparison
Click the pencil icon next to a comparison name (visible on hover in the table) to rename it. Descriptive names like "dev → prod before Q2 migration" make it easier to find comparisons later.
Deleting a comparison
Click the trash icon on a comparison row to delete it. This action cannot be undone.
Only workspace admins can delete comparisons. Members can create and view comparisons.
Refreshing a comparison
Comparisons are a point-in-time snapshot. To get an up-to-date diff, create a new comparison. Refreshing an existing comparison is not currently supported.