> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Add customer-facing names to prices

Set names for prices and show them on checkouts and emails from Paddle.

---

## What's new?

We added a new `name` field to [price entities](https://developer.paddle.com/api-reference/prices/overview.md) that you can use to describe a price to customers.

- **name** (string or null): Name of this price, shown to customers at checkout. Typically describes how often the related product bills.

If present, a price name appears next to the product name when using [overlay checkout](https://developer.paddle.com/concepts/sell/overlay-checkout.md). It's returned in [events emitted by Paddle.js](https://developer.paddle.com/paddlejs/events/overview.md), so you can use it in [inline checkout implementations](https://developer.paddle.com/concepts/sell/branded-integrated-inline-checkout.md).

## How it works

A [complete product](https://developer.paddle.com/build/products/create-products-prices.md) in Paddle is made up of [a product entity](https://developer.paddle.com/api-reference/products/overview.md) that's related to [one or more price entities](https://developer.paddle.com/api-reference/prices/overview.md).

Products describe the items that customers can purchase, and prices work with products to describe how much and how often they're billed. For example, you might have a product for a "Pro plan" that has two related prices: "Monthly" and "Yearly."

Prices have a `description` field, but this is intended for internal notes for your team. [Paddle Checkout](https://developer.paddle.com/concepts/sell/self-serve-checkout.md), [invoice documents](https://developer.paddle.com/concepts/sell/sales-assisted-invoice.md), and emails sent from Paddle include the product name only.

The new `name` field against prices lets you create customer-facing descriptions of prices. It's shown next to the product name when using overlay checkout and on emails from Paddle. It's great for showing more information about how the related product bills.

`name` is not a required field, so you're free to omit this when creating prices if you don't need to show customers this information.

{% accordion %}
{% accordion-item title="Change summary" %}

This is a summary of the changes to [fields in the Paddle API](https://developer.paddle.com/api-reference/prices/overview.md) and [webhooks](https://developer.paddle.com/webhooks/overview.md):

|                     |            |                   |
|---------------------|------------|-------------------|
| `price.name`        | **New**    | New field added.  |

This is a summary of the changes to [Paddle.js events](https://developer.paddle.com/paddlejs/events/overview.md):

|                           |          |                                                                         |
|---------------------------|----------|-------------------------------------------------------------------------|
| `data.items[].price_name` | **New**  | New field added. Returns the name of the price for the related product. |

{% /accordion-item %}
{% /accordion %}

## Next steps

This change is available in version `1` of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.

You can [create or update prices](https://developer.paddle.com/build/products/create-products-prices.md) using the API or Paddle dashboard to start adding names to your prices.
## Summary of changes

| Name | Type | Change | Entity | Description |
| --- | --- | --- | --- | --- |
| `name` | Field | added | Price | Customer-facing price name, shown at checkout. |