Overview
The job detail page is your central hub for managing and monitoring individual import or export jobs in Altera. Whether you're tracking the progress of a running job, downloading completed files, or reviewing configuration details, this page provides comprehensive information and controls for each job.
You can access the job detail page by clicking on any job from your Jobs list, or by navigating directly to a job using its unique Job ID.
Page Sections and Features
Job Status and Progress
For jobs that have been run, the top section displays:
Current step: Shows which step is currently running (e.g., "Import Orders (Step 1/1)")
Progress bar: Visual indicator of completion percentage
Item counts: Number of items processed vs. total items
Status badge: Current job status (Success, Processing, Error, etc.)
Duration: How long the job has been running or total runtime
All steps: List of all steps with status indicators
For import jobs, if any step has failed items, you can click on the "failed items" link to see the first few errors. This helps you debug issues faster without waiting for the entire job to complete.
Job Actions
Primary Actions
Run Job: For jobs that haven't been run yet
Download Output: For completed jobs (downloads the generated file)
Cancel: For jobs currently running (stops the job immediately)
Run Again: For completed export jobs or jobs with remote sources
Secondary Actions (More Actions menu)
Rename: Change the job name for easier identification
Archive/Unarchive: Hide completed jobs from your main jobs list
Clone Export: Create a new export job with the same configuration
Next Job/Previous Job: Navigate between jobs in chronological order
Job Details
Essential Information
Job ID: Unique identifier for the job - useful when contacting support
Job Type: Import or Export, plus file format (CSV or Excel)
Started: When the job began running (if applicable)
Created by: Shows who ran the job (only displayed for manually started jobs, not scheduled ones)
File Information
Output File: The generated file from exports or import results
Source File: The original uploaded file for imports
File warnings: For imports, shows any warnings or issues detected in the uploaded file
Scheduling (for scheduled jobs)
Scheduling status: Whether automatic scheduling is enabled/disabled
Next scheduled time: When the job will run next
Public URL Settings (exports only)
Output file visibility: Toggle between Private and Public
Public URL: Shareable link when file visibility is set to Public
File Downloads and Availability
Download Buttons
Output files: Download completed export files or import result files
Source files: Download the original uploaded file (imports only)
File Retention Policy
Files are automatically deleted after 180 days by default. When files are no longer available the download button will become disabled.
Important: Make sure to download any important files within 180 days of creation. See our Data Retention Policy for more details.
Import Results (imports only)
This section displays the results from your import job, showing up to 25 items from each result category:
Successful items: Items that were successfully created or updated
Failed items: Items that encountered errors during import
Skipped items: Items that were skipped based on your import settings
Depending on your import results, you may see up to 75 items total across all three categories.
Each item in the results list is clickable - clicking on any item will open a link to that specific item in your Shopify Admin where you can verify the imported data matches your expectations.
This feature helps you spot-check your imports without having to manually search for the newly created or updated items in Shopify.
Data Types (exports only)
This section shows all the data types included in your export job (Products, Orders, Customers, etc.). Clicking on any data type opens a detailed modal showing:
Configured columns: All fields included in the export
Filters: Any filters applied to limit which data is processed
Options: Additional settings specific to that data type
Data transformations: Any automatic transformations applied (if configured)
All Job Runs (exports only)
If an export job has been run multiple times, this section shows a table of all previous runs with:
Run ID: Unique identifier for each run
Type: Manual start (play icon) or scheduled start (replay icon)
Status: Success, Error, Cancelled, etc.
Started/Finished times: When each run began and completed
Use the pagination controls to navigate through older runs.
Managing Jobs
Renaming Jobs
Click More actions → Rename
Enter the new job name
Click Rename to save
Good job names help you identify jobs quickly, especially when you have many similar jobs.
Archiving Jobs
Archive completed jobs to keep your main Jobs list organized:
Click More actions → Archive
Confirm the action
Archived jobs are hidden from your main Jobs list but remain accessible. You can unarchive them anytime using the same menu.
Making Export Files Public
For export jobs, you can make the output file publicly accessible:
Find the Output file visibility section in Job Details
Toggle the switch to Public
Copy the public URL that appears
Security note: Anyone with the public URL can download the file however the URL will include a random identifier that is difficult to guess.
Troubleshooting
Import Errors
If your import job shows failed items:
Click on the "failed items" link in the All Steps section
Review the error messages to understand what went wrong
Fix issues in your source file and run the job again
File Not Available
If you can't download files:
Check if the job is older than 180 days
Files may have been automatically deleted per our retention policy
Contact support if you need help with file recovery options
Job Stuck or Taking Too Long
For jobs that seem stuck:
Use the Cancel button to stop the current run
Check for any error messages or warnings
Try running the job again
Contact support if issues persist
Getting Help
If you encounter issues or have questions about a specific job, the Job ID is the most important piece of information to provide to our support team. You can find it in the Job Details section and copy it to your clipboard for easy sharing.
For additional help, see our guides on importing Shopify data and exporting Shopify data.