# The Product Catalog Import object

### The Product Catalog Import object

```json
{
  "id": "pcimprt_test_61THl3VA5Zt5cTqbP16T9R4DRrSQbEWmWeLUx7WmOR8K",
  "object": "v2.commerce.product_catalog_import",
  "status": "awaiting_upload",
  "created": "2025-01-01T00:00:00.000Z",
  "status_details": {
    "awaiting_upload": {
      "upload_url": {
        "url": "https://stripeusercontent.com/files/us-west-2/upload/wksp_hb7cNA",
        "expires_at": "2025-01-01T01:00:00.000Z"
      }
    }
  },
  "metadata": {
    "file_name": "march_11_2026_product_upload.csv"
  }
}
```

## Attributes

- `id` (string)
  The unique identifier for this ProductCatalogImport.

- `object` (string, value is "v2.commerce.product_catalog_import")
  String representing the object’s type. Objects of the same type share the same value of the object field.

- `created` (timestamp)
  The time this ProductCatalogImport was created.

- `feed_type` (enum)
  The type of feed data being imported into the product catalog.
Possible enum values:
  - `inventory`
    Inventory levels and stock availability feed.

  - `pricing`
    Pricing information feed including costs and currency data.

  - `product`
    Product information feed including SKUs, descriptions, and attributes.

  - `promotion`
    Promotional data feed including discounts and offers.

- `livemode` (boolean)
  Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

- `metadata` (map)
  Additional information about the object in a structured format.

- `mode` (enum)
  The import strategy for handling existing catalog data.
Possible enum values:
  - `replace`
    Replace all existing catalog data with the imported data.

  - `upsert`
    Update existing records and insert new ones.

- `status` (enum)
  The current status of this ProductCatalogImport.
Possible enum values:
  - `awaiting_upload`
    The import is waiting for the file to be uploaded.

  - `failed`
    The import failed and no records were processed.

  - `processing`
    The import is processing the uploaded file.

  - `succeeded`
    The import completed successfully with all records processed.

  - `succeeded_with_errors`
    The import completed but some records failed to process.

- [`status_details`](https://docs.stripe.com/api/v2/commerce/product-catalog-imports/object.md?query=status_details) (object, nullable)
  Details about the current import status.