Skip to main content
Schema2020-08-27object

product

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)

Source
openapi/spec3.json
Commit
d70de345383d
Active snapshot
da69df7e6e11

Product

object

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/d…

active boolean
required

Whether the product is currently available for purchase.

created integer (unix-time)
required

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

description string
optionalnullable

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 string
required

Unique identifier for the object.

images array
required

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

livemode boolean
required

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

metadata object
required

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 string
required

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 string
required

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

package_dimensions
optionalnullable

The dimensions of this product for shipping purposes.

shippable boolean
optionalnullable

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

statement_descriptor string
optionalnullable

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
optionalnullable

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

unit_label string
optionalnullable

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 integer (unix-time)
required

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

url string
optionalnullable

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