Just launched
We're actively working on new content and improvements to our documentation. We'd love to hear your thoughts, launch quick survey
Paddle Billing


Product entities describe the items that you sell. They hold high-level product attributes.

Products are the items in your catalog that you sell to your customers. For simplicity and flexibility, there's no categories or hierarchies of product – everything you sell starts with a product entity.

Products work with prices, which is where you can say how much you charge for a product and how often.

Product entities hold information like:

  • What the product is called
  • How it should be taxed
  • A description of the product
  • An image to show at checkout and on invoices

Once you've created a product, you can link a price to it. You can add prices to checkouts, transactions, and subscriptions to bill for your products.

Get a step-by-step overview of how to create a product that's ready-to-sell, including prices and price overrides. See: Create products and prices

There's no delete operation for products. Use the update a product operation to archive products when you no longer need them. See: Delete entities



Unique Paddle ID for this product, prefixed with pro_.


Name of this product.

descriptionstring or null

Short description for this product.


Tax category for this product. Used for charging the correct rate of tax. Selected tax category must be enabled on your Paddle account.

image_urlnull or string<uri>

Image for this product. Included in the checkout and on some customer documents.

custom_dataobject or null

Your own structured key-value data.


Whether this entity can be used in Paddle.


RFC 3339 datetime string of when this entity was created. Set automatically by Paddle.

List products
Create a product
Get a product
Update a product