Features
Changes Tracking
Changes Tracking monitors modifications across your entire store ecosystem—themes, products, orders, and inventory. Understand what changed, when, and by whom.
Changes Tracking
Changes Tracking monitors modifications across your entire store ecosystem—themes, products, orders, and inventory. Understand what changed, when, and by whom.
Overview
When something breaks or behaves unexpectedly, the first question is always "what changed?" Changes Tracking provides:
- Theme Changes: File creations, edits, and deletions
- Product Changes: New products, updates, pricing, variants
- Order Changes: Status updates, modifications, cancellations
- Inventory Changes: Stock adjustments across locations
- Actor Identification: Who or what made the change
- AI Impact Analysis: Understand the significance of changes
Getting Started
Enabling Change Tracking
Change tracking begins automatically after installation:
- Navigate to Changes in the sidebar
- View recent changes across all categories
- Click any change for detailed information
Running a Scan
Manually scan for recent changes:
- Click Scan Now
- Select categories to scan (or all)
- Wait for scan to complete
- Review new changes detected
Change Categories
Theme Changes
Modifications to your Shopify theme files:
| Change Type | Description | Impact |
|---|---|---|
| File Created | New file added | New functionality or content |
| File Edited | Existing file modified | Changed functionality |
| File Deleted | File removed | Removed functionality |
| Theme Published | Theme made live | Site-wide change |
Product Changes
Modifications to your product catalog:
| Change Type | Description | Impact |
|---|---|---|
| Product Created | New product added | Catalog expansion |
| Product Updated | Details modified | Customer-facing change |
| Price Changed | Pricing updated | Revenue impact |
| Variant Added | New option added | Product complexity |
| Inventory Updated | Stock levels changed | Availability impact |
Order Changes
Modifications to order records:
| Change Type | Description | Impact |
|---|---|---|
| Order Created | New order placed | Revenue, inventory |
| Order Updated | Details modified | Fulfillment impact |
| Order Fulfilled | Shipped to customer | Inventory deduction |
| Order Cancelled | Customer or admin cancelled | Revenue loss |
| Order Refunded | Full or partial refund | Revenue adjustment |
Inventory Changes
Stock level modifications:
| Change Type | Description | Cause |
|---|---|---|
| Stock Increased | Inventory added | Restock, return |
| Stock Decreased | Inventory reduced | Sale, adjustment |
| Stock Transfer | Moved between locations | Rebalancing |
| Zero Stock | Item out of stock | Sales, adjustment |
Changes List
Viewing Recent Changes
┌─────────────────────────────────────────────────────────────────┐
│ RECENT CHANGES [Scan] [Filter] │
│ │
│ Filter: [All Types ▾] [All Categories ▾] [Last 7 days ▾] │
│ │
│ Today │
│ ├─ 2:30 PM Theme file edited: sections/header.liquid │
│ │ Actor: Staff (john@store.com) • Impact: Medium │
│ │ │
│ ├─ 11:15 AM Product price changed: Premium Headphones │
│ │ $99.00 → $79.00 • Actor: App (Bulk Editor) │
│ │ │
│ └─ 9:00 AM Inventory adjusted: SKU-123 │
│ +50 units at Warehouse A • Actor: Manual │
│ │
│ Yesterday │
│ ├─ 4:45 PM New product created: Winter Collection Hat │
│ │ 5 variants • Actor: Staff (sarah@store.com) │
│ │ │
│ └─ 2:00 PM Theme published: Development → Live │
│ Actor: Staff (john@store.com) • Impact: High │
│ │
│ Showing 1-5 of 127 [< Prev] [Next >] │
└─────────────────────────────────────────────────────────────────┘
Filtering Options
| Filter | Options |
|---|---|
| Type | Create, Update, Delete |
| Category | Theme, Product, Order, Inventory |
| Actor | Staff, App, Automation, Webhook |
| Impact | High, Medium, Low |
| Date Range | Today, 7 days, 30 days, Custom |
Change Details
Viewing a Change
Click any change to see full details:
┌─────────────────────────────────────────────────────────────────┐
│ CHANGE: Theme File Edited │
│ │
│ Category: Theme Type: Edit │
│ Timestamp: Jan 15, 2025 at 2:30 PM │
│ Actor: Staff (john@store.com) │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ FILE │
│ sections/header.liquid │
│ │
│ CHANGES │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ - <div class="announcement-bar"> │ │
│ │ - {{ section.settings.announcement_text }} │ │
│ │ - </div> │ │
│ │ + {%- comment -%} Announcement bar removed {%- endcomment -%}│
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ AI ANALYSIS │
│ This change removes the announcement bar from the header. │
│ Impact: Moderate - Site-wide visibility change affecting │
│ promotional messaging capability. │
│ │
│ RELATED EVENTS │
│ ├─ Order volume dropped 15% starting 3 hours after change │
│ └─ This change may be related │
│ │
│ [View in Code Editor] [Create Ticket] [Revert Change] │
└─────────────────────────────────────────────────────────────────┘
Actor Identification
Who Made Changes?
PeerScripts identifies the source of each change:
| Actor Type | Description | Examples |
|---|---|---|
| Staff | Human user in Shopify admin | john@store.com |
| App | Installed Shopify app | Bulk Price Editor |
| Automation | Shopify Flow or scheduled | Flow: Restock Alert |
| Webhook | External system via API | ERP Integration |
| Unknown | Source couldn't be determined | - |
Actor Analysis
View all changes by a specific actor:
- Click an actor name
- See all changes they made
- View patterns and frequency
- Identify potential issues
AI Impact Analysis
Automatic Analysis
PeerScripts AI analyzes changes to determine:
- Impact Level: High, Medium, Low
- Scope: How much of the store is affected
- Risk Assessment: Potential negative effects
- Recommendations: Actions to consider
Requesting Analysis
For unanalyzed changes:
- Click Analyze on the change
- Wait for AI processing
- Review impact assessment
Correlation with Anomalies
Automatic Correlation
When Store Health detects an anomaly, Changes Tracking automatically checks for related changes:
┌─────────────────────────────────────────────────────────────────┐
│ CORRELATION DETECTED │
│ │
│ Anomaly: Fulfillment rate dropped 16% │
│ Detected: Jan 15, 2025 at 2:30 PM │
│ │
│ Potentially Related Changes: │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 10:00 AM Theme change: Removed checkout optimization │ │
│ │ Confidence: 85% │ │
│ │ │ │
│ │ 11:30 AM App installed: New Shipping Calculator │ │
│ │ Confidence: 72% │ │
│ │ │ │
│ │ 1:00 PM Product inventory zeroed: Popular item │ │
│ │ Confidence: 65% │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ [View Full Timeline] │
└─────────────────────────────────────────────────────────────────┘
Manual Investigation
Use the timeline view to investigate:
- Select a date range around the anomaly
- View all changes in chronological order
- Identify likely causes
- Take corrective action
Change Scanning
Automatic Scanning
Changes are detected automatically:
- Theme changes: Real-time via webhooks
- Product changes: Periodic sync + webhooks
- Order changes: Real-time via webhooks
- Inventory: Periodic sync
Manual Scanning
Force a scan for latest changes:
- Click Scan Now
- Select categories
- Wait for completion
- Review results
Taking Action
From Change to Resolution
- Identify concerning changes
- Analyze their impact
- Correlate with anomalies
- Revert if needed
- Create ticket to track follow-up
Reverting Changes
For theme changes, revert directly:
- View the change details
- Click Revert Change
- Confirm the reversion
- Verify the file was restored
Note: Only theme file changes can be directly reverted. Product/order changes must be manually corrected in Shopify.
Export & Reporting
Export Options
Export change data for analysis:
- CSV: Spreadsheet format
- JSON: Developer-friendly format
- PDF Report: Formatted change report
Change Audit Reports
Generate audit reports:
- Select date range
- Choose categories
- Click Generate Report
- Download or share
Best Practices
Regular Review
- Daily: Review high-impact changes
- Weekly: Scan through all change categories
- Before deployments: Check for unexpected changes
Investigation Process
When something breaks:
- Check Changes for recent modifications
- Look at Store Health correlations
- Identify the most likely cause
- Take corrective action
- Document in a ticket
Establishing Accountability
- Ensure all team members use unique logins
- Review app permissions regularly
- Monitor automation changes
- Track external integrations
Troubleshooting
Missing Changes
- Some changes may take time to sync
- Check filter settings
- Verify webhook delivery
Incorrect Actor
- Apps may show as the actor for changes made through them
- Some bulk changes may not identify the originator
- Check Shopify audit log for additional detail
Slow Scanning
- Large change volumes may take longer
- Use date filters to narrow scope
- Consider category-specific scans
Related Features
- Store Health - Anomaly detection
- Theme Intelligence - Theme code analysis
- App Intelligence - Installed app monitoring