Jobs
The Jobs page lists all catalog generation runs in the system. Each job represents a single request to build a product catalog for a specific customer from a set of SKUs. Jobs move through a processing pipeline — from Pending through image resolution and building, to Completed or Failed — and the list updates in real time via a live connection.

Accessing the Page
Section titled “Accessing the Page”Navigate to Catalog Automation → Jobs in the sidebar, or go to /catalog-automation/jobs.
What you can do here
Section titled “What you can do here”- View all catalog generation jobs and their current processing status.
- Search jobs by customer name or reference number.
- Filter by status or date range to find specific runs.
- Create a new catalog job for a customer.
- Retry a failed job after fixing the underlying issue.
- Delete completed, failed, or cancelled jobs when they are no longer needed.
Common tasks
Section titled “Common tasks”- Open the page from the sidebar under Catalog Automation.
- Apply a Status or Date Range filter to narrow the list, or search by customer name.
- Click a row to open the job detail drawer for full execution metadata.
- To create a new catalog, click New Job and fill in the dialog.
- To retry a failed job, click the Retry icon on its row.
- Job status updates arrive in real time — the page does not need to be manually refreshed.
- The Retry action is only available for jobs with status Failed.
- The Delete action is only available for jobs with status Completed, Failed, or Cancelled. In-progress jobs cannot be deleted.
- Deleting a job also deletes its associated catalog and all stored files. This action cannot be undone.
- Only active Definitions are listed in the Create Job dialog. If no active definitions exist, the job cannot be created.
List Columns
Section titled “List Columns”| Column | Default Visible | Sortable | Description |
|---|---|---|---|
| Customer | Yes | No | Customer name and email for whom the catalog is being generated |
| Reference | Yes | No | Optional internal reference (e.g., a purchase order number) |
| Definition | Yes | No | Name of the catalog definition used for this run |
| Items | Yes | No | Number of SKUs submitted for this job |
| Status | Yes | No | Current processing status with an error icon on failed jobs |
| Created | Yes | No | Relative time since job was submitted; hover for full date |
Status Values
Section titled “Status Values”| Status | Description |
|---|---|
| Pending | Job is queued and waiting to start |
| Processing | General processing phase underway |
| Image Resolution | System is locating images for each SKU from the image source |
| Building | HTML catalog and ZIP archive are being assembled |
| Completed | Job finished successfully; catalog is available |
| Failed | Job encountered an error; an error icon shows the message on hover |
| Cancelled | Job was cancelled before completion |
Filtering
Section titled “Filtering”| Filter | Type | Description |
|---|---|---|
| Search | Free text | Search by customer name or reference number |
| Status | Dropdown | Filter by job status; default shows all statuses |
| Date Range | Dropdown | Filter by Today, 7 Days, or 30 Days; default shows all |
| Mode | Dropdown | Filter by Production or Test Only — available in the expanded filter panel |
Sorting
Section titled “Sorting”The jobs list does not support column-level sorting. Records are returned in reverse-chronological order (newest first) from the server.
Pagination
Section titled “Pagination”The list uses a Load More pattern with infinite scroll:
- Page size: 20 records per load
- Scrolling near the bottom of the list automatically loads the next batch
- A message displays the total count when all results are shown
Actions
Section titled “Actions”Page Actions
Section titled “Page Actions”| Action | Description | Permission |
|---|---|---|
| New Job | Opens the Create Job dialog | catalog-automation.jobs (Write) |
| Refresh | Reloads the job list from the server | — |
Row Actions
Section titled “Row Actions”Each row provides icon buttons:
| Action | Description | Permission |
|---|---|---|
| View | Opens the job detail drawer with execution metadata | catalog-automation.jobs (Read) |
| Retry | Resubmits a failed job — only visible for Failed jobs | catalog-automation.jobs (Write) |
| Delete | Removes the job and its catalog — only available for Completed, Failed, or Cancelled jobs | catalog-automation.jobs (Admin) |
Clicking anywhere on a row also opens the detail drawer.
Creating a Job
Section titled “Creating a Job”Click New Job in the page header to open the Create Catalog Job dialog. The dialog generates a catalog by selecting a definition and providing customer details and product items.

| Field | Required | Type | Description | Default | Validation |
|---|---|---|---|---|---|
| Catalog Definition | Yes | Dropdown | Active definition to use for catalog generation — only active definitions are listed | — | Must select a definition |
| Customer Name | Yes | Text | Name of the customer receiving the catalog | — | Cannot be empty |
| Customer Email | Yes | Email address of the customer | — | Must be a valid email address | |
| Phone (WhatsApp) | No | Tel | Customer phone number for WhatsApp delivery | — | — |
| Reference | No | Text | Internal reference such as a purchase order number | — | — |
| Items | Yes | Table | One or more product rows; each row has SKU, Description, Quantity, and Price | One empty row | At least one row; each row requires a SKU |
To create a job:
- Click New Job.
- Select a Catalog Definition from the dropdown.
- Enter the Customer Name and Customer Email.
- Optionally add a Phone (WhatsApp) number and Reference.
- Fill in at least one item row with a SKU. Add more rows with Add Item.
- Click Create Job.
After submission the dialog closes and the new job appears in the list with status Pending.
Editing a Job
Section titled “Editing a Job”Jobs cannot be edited after they are created. To regenerate a catalog with different data, create a new job.
Deleting a Job
Section titled “Deleting a Job”- Locate the job in the list (only Completed, Failed, or Cancelled jobs show the delete icon).
- Click the Delete (trash) icon on the row.
- A confirmation dialog warns that the job, its catalog, and all stored files will be permanently deleted.
- Click Delete to confirm.
Related Pages
Section titled “Related Pages”- Catalogs — View the output catalogs generated by completed jobs
- Definitions — Configure the automation rules used when creating jobs
- Monitor — Dashboard overview of recent job activity and KPI counts