> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voucherify.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage products

> A guide on how to create, import, and organize products and SKUs

In the **Products** section, you can build and manage your product inventory. By defining standard and custom product attributes, you can create specific rules for promotions and loyalty programs.

## Key terms

Before you begin, familiarize yourself with these core concepts:

<AccordionGroup>
  <Accordion title="Product ID">
    A unique internal identifier assigned automatically by Voucherify, for example `prod_09268673c85013482b`.
  </Accordion>

  <Accordion title="Source ID">
    An optional external ID that matches the product identifier used in your own system.
  </Accordion>

  <Accordion title="SKU">
    A product variant. SKUs inherit metadata from the product but can also have their own attributes.
  </Accordion>
</AccordionGroup>

## Add products

You can create products in the dashboard or import them in bulk. Adding products is optional, but it helps organize campaigns and define product-based rules more clearly.

### Create a product in the Dashboard

When you create a new product, you can add its details, variants, and metadata.

Go to **Products** and **Create product** to add a new item.

<Steps>
  <Step title="Add details">
    * **Name (Required)**: Enter the product name.
    * **Source ID**: Provide your unique external identifier (optional).
    * **Price**: Set the price of the product (optional). The currency is defined in **Project settings**.
    * **Attribute**: This corresponds to variants (optional).
    * **Choose image**: Upload an image of your product (optional).
  </Step>

  <Step title="SKUs (optional)">
    Use **Create SKU** to add variants. Each SKU can have its own name, source ID, price, image, attributes, and metadata.
  </Step>

  <Step title="Metadata (optional)">
    Add custom attributes for tracking, optimizing, or experimenting.

    You can either:

    * **Use an existing metadata schema**.
    * **Add unknown property**: metadata that isn't defined and won't be added to the schema.
    * **Add to schema**: define new metadata schema. Once saved, reload the schema to use the new metadata.

    <Note>
      Read [Metadata](/prepare/metadata) to learn more about custom attributes.
    </Note>
  </Step>

  <Step title="Summary">
    Check the information in the **Summary** and **Save** to add the product to your catalog.
  </Step>
</Steps>

### Bulk import with CSV

You can use CSV files to import new products and SKUs or update existing product names.

<Info>
  **File Requirements:**

  * Maximum file size: 10 MB.
  * Dates must follow **ISO 8601** (e.g., `2024-03-11`).
  * Metadata headers must not contain spaces.
</Info>

#### Import products and SKUs

<Steps>
  <Step title="Prepare the file">
    Download the [CSV Import Template](/examples/import-products-template.csv) and fill it with your product data.
    <Tip>To import SKUs, include the `Product ID` of the parent product to link them correctly.</Tip>
  </Step>

  <Step title="Upload file">
    Go to **Products** and click the **Import CSV** tool in the top right. Select **Import products** and upload your file.
  </Step>

  <Step title="Map fields">
    Map your CSV columns to Voucherify fields.
  </Step>

  <Step title="Summary">
    Click **Import**. Voucherify processes the file and notifies you in the **Notification Center** when finished.
  </Step>
</Steps>

## Export product data

You can export all products, all SKUs, or a filtered list of products and SKUs.

Go to **Campaign hub** > **Products** to **Export** products.

<Steps>
  <Step title="Select attributes">
    Choose which standard fields and custom attributes (metadata) to include in the exported CSV.

    The date and times of the exported data are in the UTC time zone.
  </Step>

  <Step title="Export">
    Once ready, **Export** your list. The file will be generated and delivered to your **Notifications Center**.

    You can also find all your exported files in **Audit log** > **Exports**.

    <Note>
      Larger exports may take longer to generate.
    </Note>
  </Step>
</Steps>

## Related features

Products can be reused across campaigns, rules, and developer workflows. The features below show how product data connects to other parts of Voucherify.

<AccordionGroup>
  <Accordion title="Product collections">
    You can group products into [collections](/prepare/product-collections) based on attributes, SKUs, or metadata. Collections help you manage large catalogs and reuse the same product selection across multiple campaigns.
  </Accordion>

  <Accordion title="Use products in discounts and BOGO scenarios">
    Products can be used in [product discounts](/build/discount-promotion-overview) and [BOGO campaigns](/build/product-bundles). You can apply discounts to specific products or collections, or define which items are required and rewarded in a BOGO offer.
  </Accordion>

  <Accordion title="Use products in validation rules">
    Product data can be used in [validation rules](/optimize/validation-rules-reference) to control when a promotion applies. For example, you can limit a campaign to selected products or require specific items in the cart.
  </Accordion>

  <Accordion title="Developer setup: Products API">
    You can manage products and SKUs using the [Products API](/api-reference/products/product-object). This includes creating products, importing them in bulk, updating SKUs, and keeping product data in sync with external systems.
  </Accordion>
</AccordionGroup>