Section 30 — Usage
The Usage tab provides a detailed, item-level view of all enrichment activity that contributes to usage-based billing. While the Billing tab summarizes costs at a high level, the Usage tab shows the granular breakdown of each enrichment action as it occurs.
This view is designed for transparency and traceability, not configuration.
Usage Table Overview
Each row in the Usage table represents a single enrichment event. The table includes the following columns:
- Date / Time (UTC)Displays when the enrichment occurred. All activity is logged in UTC for consistency across regions.
- Subject
Identifies the specific object that was enriched: - Product
- Image
- Variant
- Category
- Clicking the subject link takes you directly to that item inside CatalogPilot (for example, opening the related image or product).
- Usage Type
Indicates the action performed.
Most entries will show “Enrichment of Subject”, which represents a successful enrichment event.
- Amount
Displays the usage cost associated with that single action.
- Prices may appear to three decimal places internally for accuracy.
- Final invoiced amounts are rounded to standard two-decimal currency values.
- Status
Shows the billing state of the usage item.
- Assigned to Invoice means the enrichment has been recorded and queued for the next billing cycle.
- Items remain in this state until the weekly invoice is generated.
How Usage Relates to Billing
- Usage entries appear immediately as enrichment actions occur.
- Once recorded, they are assigned to the upcoming invoice.
- Usage is billed weekly, separate from subscription charges.
- Subscription fees are handled independently and do not appear in the Usage table.
Navigating Usage Details
- Clicking on a Subject opens the related product, image, or category.
- Clicking on the Usage Type reveals internal details about what fields were generated during that enrichment event.
- This allows merchants to audit exactly what was enriched, when, and at what cost.
Important Notes
- Not every action in CatalogPilot is billable.
Only enrichment-related actions generate usage entries. - All actions—billable or not—are logged elsewhere for system transparency, but the Usage tab focuses exclusively on billable enrichment events.