# product

From **Stripe API**.

Products describe the specific goods or services you offer to your customers.
For example, you might offer a Standard and Premium version of your goods or service; each version would be a separate Product.
They can be used in conjunction with [Prices](https://stripe.com/docs/api#prices) to configure pricing in Checkout and Subscriptions.

Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription) or accept [one-time payments with Checkout](https://stripe.com/docs/payments/checkout/client#create-products) and more about [Products and Prices](https://stripe.com/docs/billing/prices-guide)

- Type: `object`

## Properties

### `active`

- Required: true
- Type: `boolean`

Whether the product is currently available for purchase.

### `created`

- Required: true
- Type: `integer`
- Format: `unix-time`

Time at which the object was created. Measured in seconds since the Unix epoch.

### `description`

- Required: false
- Type: `string`
- Nullable: true
- maxLength: `5000`

The product's description, meant to be displayable to the customer. Use this field to optionally store a long form explanation of the product being sold for your own rendering purposes.

### `id`

- Required: true
- Type: `string`
- maxLength: `5000`

Unique identifier for the object.

### `images`

- Required: true
- Type: `array`

A list of up to 8 URLs of images for this product, meant to be displayable to the customer.

### `livemode`

- Required: true
- Type: `boolean`

Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

### `metadata`

- Required: true
- Type: `object`

Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

### `name`

- Required: true
- Type: `string`
- maxLength: `5000`

The product's name, meant to be displayable to the customer. Whenever this product is sold via a subscription, name will show up on associated invoice line item descriptions.

### `object`

- Required: true
- Type: `string`
- Allowed values: `"product"`

String representing the object's type. Objects of the same type share the same value.

### `package_dimensions`

- Required: false
- Nullable: true

The dimensions of this product for shipping purposes.

### `shippable`

- Required: false
- Type: `boolean`
- Nullable: true

Whether this product is shipped (i.e., physical goods).

### `statement_descriptor`

- Required: false
- Type: `string`
- Nullable: true
- maxLength: `5000`

Extra information about a product which will appear on your customer's credit card statement. In the case that multiple products are billed at once, the first statement descriptor will be used.

### `tax_code`

- Required: false
- Nullable: true

A [tax code](https://stripe.com/docs/tax/tax-codes) ID.

### `unit_label`

- Required: false
- Type: `string`
- Nullable: true
- maxLength: `5000`

A label that represents units of this product in Stripe and on customers’ receipts and invoices. When set, this will be included in associated invoice line item descriptions.

### `updated`

- Required: true
- Type: `integer`
- Format: `unix-time`

Time at which the object was last updated. Measured in seconds since the Unix epoch.

### `url`

- Required: false
- Type: `string`
- Nullable: true
- maxLength: `2048`

A URL of a publicly-accessible webpage for this product.

## JSON Schema

```json
{"description":"Products describe the specific goods or services you offer to your customers.\nFor example, you might offer a Standard and Premium version of your goods or service; each version would be a separate Product.\nThey can be used in conjunction with [Prices](https://stripe.com/docs/api#prices) to configure pricing in Checkout and Subscriptions.\n\nRelated guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription) or accept [one-time payments with Checkout](https://stripe.com/docs/payments/checkout/client#create-products) and more about [Products and Prices](https://stripe.com/docs/billing/prices-guide)","properties":{"active":{"description":"Whether the product is currently available for purchase.","type":"boolean"},"created":{"description":"Time at which the object was created. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"description":{"description":"The product's description, meant to be displayable to the customer. Use this field to optionally store a long form explanation of the product being sold for your own rendering purposes.","maxLength":5000,"nullable":true,"type":"string"},"id":{"description":"Unique identifier for the object.","maxLength":5000,"type":"string"},"images":{"description":"A list of up to 8 URLs of images for this product, meant to be displayable to the customer.","items":{"maxLength":5000,"type":"string"},"type":"array"},"livemode":{"description":"Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.","type":"boolean"},"metadata":{"additionalProperties":{"maxLength":500,"type":"string"},"description":"Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.","type":"object"},"name":{"description":"The product's name, meant to be displayable to the customer. Whenever this product is sold via a subscription, name will show up on associated invoice line item descriptions.","maxLength":5000,"type":"string"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["product"],"type":"string"},"package_dimensions":{"anyOf":[{"$ref":"#/components/schemas/package_dimensions"}],"description":"The dimensions of this product for shipping purposes.","nullable":true},"shippable":{"description":"Whether this product is shipped (i.e., physical goods).","nullable":true,"type":"boolean"},"statement_descriptor":{"description":"Extra information about a product which will appear on your customer's credit card statement. In the case that multiple products are billed at once, the first statement descriptor will be used.","maxLength":5000,"nullable":true,"type":"string"},"tax_code":{"anyOf":[{"maxLength":5000,"type":"string"},{"$ref":"#/components/schemas/tax_code"}],"description":"A [tax code](https://stripe.com/docs/tax/tax-codes) ID.","nullable":true,"x-expansionResources":{"oneOf":[{"$ref":"#/components/schemas/tax_code"}]}},"unit_label":{"description":"A label that represents units of this product in Stripe and on customers’ receipts and invoices. When set, this will be included in associated invoice line item descriptions.","maxLength":5000,"nullable":true,"type":"string"},"updated":{"description":"Time at which the object was last updated. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"url":{"description":"A URL of a publicly-accessible webpage for this product.","maxLength":2048,"nullable":true,"type":"string"}},"required":["active","created","id","images","livemode","metadata","name","object","updated"],"title":"Product","type":"object","x-expandableFields":["package_dimensions","tax_code"],"x-resourceId":"product"}
```