Skip to main content

Viewing Job History

Job History provides a comprehensive record of all bulk editing operations performed in your store. This powerful feature allows you to track changes, monitor performance, and maintain accountability for all product modifications.

What is Job History?​

Job History is a detailed log of every bulk editing job executed in your store, including manual edits, scheduled jobs, and recurring tasks. Each entry contains complete information about what was changed, when, and by whom.

Benefits​

  • Complete Audit Trail - Track every change made to your products
  • Performance Monitoring - Analyze job execution times and success rates
  • Accountability - See who made what changes and when
  • Troubleshooting - Investigate issues with detailed execution logs

Accessing Job History​

  1. Go to the main dashboard
  2. Click "Job History" in the navigation menu
  3. Or access from any completed job notification

History Dashboard​

The Job History dashboard shows:

  • Recent Jobs - Latest bulk editing operations
  • Job Status - Success, failed, or in progress
  • Execution Time - When jobs started and completed
  • User Information - Who initiated each job
  • Product Count - Number of products affected

Job History Details​

Job Information​

Each job entry includes:

Job ID: BPE-2024-001234
Name: "Weekly Price Update - Electronics"
Type: Recurring Job
Status: Completed Successfully
User: john.doe@yourstore.com
Started: 2024-01-15 02:00:15 UTC
Completed: 2024-01-15 02:03:42 UTC
Duration: 3 minutes 27 seconds
Products Affected: 1,247 products

Change Summary​

Overview of modifications made:

  • Fields Modified - Which product/variant fields were changed
  • Change Types - Fixed values, formulas, find/replace operations
  • Success Rate - Percentage of successful updates
  • Error Count - Number of failed operations

Detailed Change Log​

Product-by-product breakdown:

Product: "Wireless Headphones - Black"
SKU: WH-001-BLK
Changes:
  - Price: $99.99 → $89.99
  - Compare At Price: null → $99.99
  - Tags: "electronics" → "electronics, sale"
Status: Success

Filter Options​

Find specific jobs using filters:

  • Date Range - Jobs within specific time periods
  • Job Type - Manual, scheduled, or recurring jobs
  • Status - Successful, failed, or in progress
  • User - Jobs by specific team members
  • Product Count - Jobs affecting certain numbers of products

Search Functionality​

Search job history by:

  • Job Name - Find jobs by descriptive names
  • Product SKU - See all jobs affecting specific products
  • Field Names - Find jobs that modified specific fields
  • Change Values - Search for specific values that were set

Advanced Filters​

Combine multiple criteria:

Date Range: Last 30 days
AND Job Type: Scheduled
AND Status: Failed
AND User: marketing-team@yourstore.com

Job Status Types​

Completed Successfully​

  • All planned changes were applied
  • No errors encountered
  • Products updated as expected

Completed with Errors​

  • Some changes were successful
  • Some products failed validation
  • Partial completion with error report

Failed​

  • Job could not complete
  • System errors or validation failures
  • No changes were applied

In Progress​

  • Job is currently running
  • Real-time progress updates
  • Estimated completion time

Cancelled​

  • Job was manually stopped
  • Changes made before cancellation are preserved
  • Reason for cancellation logged

Performance Analytics​

Execution Metrics​

Track job performance over time:

  • Average Duration - How long jobs typically take
  • Success Rates - Percentage of successful completions
  • Error Trends - Common failure patterns
  • Peak Usage - Busiest times for bulk editing

Resource Usage​

Monitor system impact:

  • Products per Minute - Processing speed
  • API Calls - Shopify API usage
  • Memory Usage - System resource consumption
  • Concurrent Jobs - Multiple job execution

Analyze patterns over time:

  • Monthly Activity - Bulk editing frequency
  • Seasonal Patterns - Peak usage periods
  • User Activity - Team member usage patterns
  • Error Rates - Quality trends over time

Exporting Job History​

Export Options​

Download job history data:

  • CSV Format - For spreadsheet analysis
  • JSON Format - For technical integration
  • PDF Reports - For documentation and sharing
  • Custom Formats - Tailored to your needs

Export Filters​

Choose what to include:

  • Date Range - Specific time periods
  • Job Types - Manual, scheduled, or recurring
  • Detail Level - Summary or full details
  • User Selection - Specific team members

Scheduled Reports​

Automate report generation:

  • Weekly Summaries - Regular activity reports
  • Monthly Analytics - Performance and trend analysis
  • Error Reports - Failed job notifications
  • Custom Schedules - Tailored to your needs

Compliance and Auditing​

Audit Trail Requirements​

Meet compliance needs with:

  • Complete Change Records - Every modification tracked
  • User Attribution - Who made each change
  • Timestamp Accuracy - Precise timing information
  • Data Integrity - Tamper-proof logging

Retention Policies​

Configure data retention:

  • Standard Retention - 12 months of history
  • Extended Retention - Up to 7 years for compliance
  • Selective Retention - Keep important jobs longer
  • Automatic Cleanup - Remove old data automatically

Access Controls​

Manage who can view history:

  • Role-Based Access - Different levels for different users
  • Department Filtering - Users see only relevant jobs
  • Admin Override - Full access for administrators
  • Audit Logging - Track who accessed what data

Troubleshooting with Job History​

Investigating Issues​

Use job history to diagnose problems:

  1. Identify the Problem - When did issues start?
  2. Find Related Jobs - What changes were made around that time?
  3. Analyze Patterns - Are there recurring issues?
  4. Check Dependencies - Did one job affect another?

Common Investigation Scenarios​

Unexpected Price Changes

Search: Field = "price" AND Date = last 7 days
Review: All price-related jobs
Identify: Which job caused the unexpected change

Missing Product Data

Search: Product SKU = "MISSING-001"
Review: All jobs affecting this product
Identify: When data was last modified

Performance Degradation

Filter: Duration > 10 minutes AND Date = last month
Analyze: What made these jobs slow?
Optimize: Improve filters or reduce scope

Best Practices​

Regular Monitoring​

  • Review job history weekly
  • Monitor error rates and trends
  • Check for unusual activity patterns
  • Verify important changes were applied correctly

Documentation​

  • Use descriptive job names
  • Add detailed descriptions for complex jobs
  • Document the purpose of recurring jobs
  • Maintain notes about important changes

Data Management​

  • Export important job records regularly
  • Archive old data according to policies
  • Clean up test jobs and duplicates
  • Maintain organized job naming conventions

Team Coordination​

  • Share job history access appropriately
  • Use job history for team communication
  • Document standard procedures
  • Train team members on history features

Integration and API​

API Access​

Access job history programmatically:

  • REST API - Standard HTTP endpoints
  • GraphQL - Flexible query interface
  • Webhooks - Real-time job notifications
  • Bulk Export - Large data downloads

Third-Party Integration​

Connect with other systems:

  • Analytics Platforms - Send data to BI tools
  • Monitoring Systems - Alert on job failures
  • Compliance Tools - Export for audit systems
  • Backup Systems - Archive job history data

Next Steps​