# Embeddable pricing table for subscriptions Display a subscription pricing table on your website and take customers directly to Stripe Checkout. You can use the Stripe Dashboard to create a table that displays different subscription pricing levels to your customers. You don’t need to write any custom code to create or embed a pricing table. This guide describes how to: * Use the Stripe Dashboard to configure the UI component * Copy the generated code from the Dashboard * Embed the code on your website to show your customers pricing information and take them to a checkout page ## Overview ![The pricing table is an embedded UI that displays pricing information and takes customers to checkout.](images/checkout/pricing-table/pricing-table-embed.png) Embed a pricing table on your website to display pricing details and convert customers to checkout. A pricing table is an embeddable UI that: * Displays *pricing information* and takes customers to a prebuilt checkout flow. The checkout flow uses [Stripe Checkout](https://docs.stripe.com/payments/checkout.md) to complete the purchase. * Supports common subscription business models like [flat-rate](https://docs.stripe.com/products-prices/pricing-models.md#flat-rate), [per-seat](https://docs.stripe.com/products-prices/pricing-models.md#per-seat), [tiered pricing](https://docs.stripe.com/products-prices/pricing-models.md#tiered-pricing), and free trials. * Lets you configure, customize, and update product and pricing information directly in the Dashboard, without needing to write any code. * Embeds into your website with a ` ``` ```html ``` ```jsx import * as React from 'react'; function PricingPage() { // Paste the stripe-pricing-table snippet in your React component return ( ); } export default PricingPage; ``` ```typescript import * as React from 'react'; // If using TypeScript, add the following snippet to your file as well. declare global { namespace JSX { interface IntrinsicElements { 'stripe-pricing-table': React.DetailedHTMLProps, HTMLElement>; } } } ``` ## Track subscriptions When a customer purchases a subscription, you’ll see it on the [subscriptions page](https://dashboard.stripe.com/subscriptions) in the Dashboard. ### Handle fulfillment with the Stripe API The pricing table component uses Stripe Checkout to render a prebuilt, hosted payment page. When a payment is completed using Checkout, Stripe sends the [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed) event. Register an [event destination](https://docs.stripe.com/event-destinations.md) to receive the event at your endpoint to process fulfillment and reconciliation. See the [Checkout fulfillment guide](https://docs.stripe.com/checkout/fulfillment.md) for more details. The `` web component supports setting the `client-reference-id` property. When the property is set, the pricing table passes it to the Checkout Session’s [client_reference_id](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-client_reference_id) attribute to help you reconcile the Checkout Session with your internal system. This can be an authenticated user ID or a similar string. `client-reference-id` can be composed of alphanumeric characters, dashes, or underscores, and be any value up to 200 characters. Invalid values are silently dropped and your pricing table will continue to work as expected. Since the pricing table is embedded on your website and is accessible to anyone, check that `client-reference-id` does not include sensitive information or secrets, such as passwords or API keys. ```html

We offer plans that help any business!

``` ```jsx import * as React from 'react'; function PricingPage() { // Paste the stripe-pricing-table snippet in your React component return ( ); } export default PricingPage; ``` ## Add product marketing features The pricing table can display your products’ marketing features to help your customers decide what to purchase. To add marketing features to a product in your pricing table, go to **Additional options** > **Feature list**. ![Add product marketing features](images/checkout/pricing-table/pricing-table-feature-list-edit.png) Add product marketing features You can also add marketing features when creating or updating products with the API. ```dotnet StripeConfiguration.ApiKey = "<>"; var options = new ProductCreateOptions { Name = "Professional", MarketingFeatures = new List { new ProductMarketingFeatureOptions { Name = "Unlimited boards" }, new ProductMarketingFeatureOptions { Name = "Up to 20 seats" }, }, }; var service = new ProductService(); Product product = service.Create(options); ``` ```go stripe.Key = "<>" params := &stripe.ProductParams{ Name: stripe.String("Professional"), MarketingFeatures: []*stripe.ProductMarketingFeatureParams{ &stripe.ProductMarketingFeatureParams{Name: stripe.String("Unlimited boards")}, &stripe.ProductMarketingFeatureParams{Name: stripe.String("Up to 20 seats")}, }, }; result, err := product.New(params); ``` ```java Stripe.apiKey = "<>"; ProductCreateParams params = ProductCreateParams.builder() .setName("Professional") .addMarketingFeature( ProductCreateParams.MarketingFeature.builder().setName("Unlimited boards").build() ) .addMarketingFeature( ProductCreateParams.MarketingFeature.builder().setName("Up to 20 seats").build() ) .build(); Product product = Product.create(params); ``` ```node const stripe = require('stripe')('<>'); const product = await stripe.products.create({ name: 'Professional', marketing_features: [ { name: 'Unlimited boards', }, { name: 'Up to 20 seats', }, ], }); ``` ```python import stripe stripe.api_key = "<>" product = stripe.Product.create( name="Professional", marketing_features=[{"name": "Unlimited boards"}, {"name": "Up to 20 seats"}], ) ``` ```php $stripe = new \Stripe\StripeClient('<>'); $product = $stripe->products->create([ 'name' => 'Professional', 'marketing_features' => [['name' => 'Unlimited boards'], ['name' => 'Up to 20 seats']], ]); ``` ```ruby Stripe.api_key = '<>' product = Stripe::Product.create({ name: 'Professional', marketing_features: [{name: 'Unlimited boards'}, {name: 'Up to 20 seats'}], }) ``` ## Add a custom call-to-action The pricing table allows you to configure a product with a custom call-to-action that redirects to any URL. You can use this if you have custom pricing or a high-touch sales process for one of your products. Click `Add product with custom call-to-action button` to choose a product and a custom call-to-action, and to set the URL. ![Add custom call-to-action](images/checkout/pricing-table/pricing-table-custom-call-to-action.png) Add custom call-to-action Custom call-to-action supports these formats: * Absolute links, like `https://wwww.stripe.com`. * Relative links like `/contact`. If you embed your pricing table on `wwww.stripe.com/pricing-table`, a URL of `/contact` navigates to `wwww.stripe.com/pricing-table/contact`. * Contact-specific links that use `mailto` and `tel`. For example, you can configure the URL to be `mailto:email@yourcompany.com` or `tel:xxx-xxx-xxx`. * Links that include two variables,`{PRODUCT_ID}` and `{CUSTOMER_EMAIL}`. Stripe populates the relevant product ID and the customer email when a customer clicks the call-to-action. You can only set one product to have a custom call-to-action button at this time. Ensure that the link you provide is correct. You must pass in the customer email for the `{CUSTOMER_EMAIL}` parameter to work. ## Pass the customer email The `` web component supports setting the `customer-email` property. When the property is set, the pricing table passes it to the Checkout Session’s [customer_email](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_email) attribute, automatically entering the email address on the payment page. ```html

We offer plans that help any business!

``` ```jsx import * as React from 'react'; function PricingPage() { // Paste the stripe-pricing-table snippet in your React component return ( ); } export default PricingPage; ``` ## Pass an existing customer You can provide an existing [Customer object](https://docs.stripe.com/api/customers.md) to Checkout Sessions created from the pricing table. Create a customer session for a user you’ve already authenticated server-side and return the [client_secret](https://docs.stripe.com/api/customer_sessions/object.md#customer_session_object-client_secret) to the client. ```dotnet StripeConfiguration.ApiKey = "<>"; var options = new CustomerSessionCreateOptions { Customer = "<>", Components = new CustomerSessionComponentsOptions { PricingTable = new CustomerSessionComponentsPricingTableOptions { Enabled = true }, }, }; var service = new CustomerSessionService(); CustomerSession customerSession = service.Create(options); ``` ```go stripe.Key = "<>" params := &stripe.CustomerSessionParams{ Customer: stripe.String("<>"), Components: &stripe.CustomerSessionComponentsParams{ PricingTable: &stripe.CustomerSessionComponentsPricingTableParams{Enabled: stripe.Bool(true)}, }, }; result, err := customersession.New(params); ``` ```java Stripe.apiKey = "<>"; CustomerSessionCreateParams params = CustomerSessionCreateParams.builder() .setCustomer("<>") .setComponents( CustomerSessionCreateParams.Components.builder() .setPricingTable( CustomerSessionCreateParams.Components.PricingTable.builder().setEnabled(true).build() ) .build() ) .build(); CustomerSession customerSession = CustomerSession.create(params); ``` ```node const stripe = require('stripe')('<>'); const customerSession = await stripe.customerSessions.create({ customer: '<>', components: { pricing_table: { enabled: true, }, }, }); ``` ```python import stripe stripe.api_key = "<>" customer_session = stripe.CustomerSession.create( customer="<>", components={"pricing_table": {"enabled": True}}, ) ``` ```php $stripe = new \Stripe\StripeClient('<>'); $customerSession = $stripe->customerSessions->create([ 'customer' => '<>', 'components' => ['pricing_table' => ['enabled' => true]], ]); ``` ```ruby Stripe.api_key = '<>' customer_session = Stripe::CustomerSession.create({ customer: '<>', components: {pricing_table: {enabled: true}}, }) ``` Set the `customer-session-client-secret` attribute on the `` web component to the [client_secret](https://docs.stripe.com/api/customer_sessions/object.md#customer_session_object-client_secret) from the Customer Session. ```html

We offer plans that help any business!

``` ```jsx import * as React from 'react'; function PricingPage() { return ( ); } export default PricingPage; ``` ### Customer client secret expiration You have 30 minutes to include the client secret in the pricing table. After rendering the pricing table, you have an additional 30 minutes to complete a payment before the customer session expires. If you create a Checkout Session with an expired customer session, we discard the client secret and create the Checkout Session with no associated customer. If the customer session expires after Checkout Session creation, but before confirmation, payment confirmation fails. ## Customize the post-purchase experience After a successful payment, your customer sees a localized confirmation message thanking them for their purchase. You can customize the confirmation message or redirect to a URL of your choice. To change the confirmation behavior on a pricing table, click the **Confirmation page** section when creating or updating the pricing table. If you redirect your customers to your own confirmation page, you can include `{CHECKOUT_SESSION_ID}` in the redirect URL to dynamically pass the customer’s current Checkout Session ID. This can be helpful if you want to tailor the success message on your website based on the information in the Checkout Session. ## Update pricing table You can update a pricing table from its details page in the Dashboard. On the **Product catalog** page, select the [Pricing tables tab](https://dashboard.stripe.com/pricing-tables), then find and select the pricing table you want to edit. On the pricing table details page, click **Edit pricing table**. You can change which products and prices you display and configure the payment page settings. When you save your changes, Stripe automatically updates the pricing table UI. ## Configure free trials To offer a free trial for a price, select **Include a free trial** and set the length of the trial when you create or edit a [pricing table](https://dashboard.stripe.com/test/pricing-tables). After customers confirm their payment details, they’re redirected to a page where they can start their trial. The new page is part of a Checkout Session. ![Configure a free trial for your products](images/checkout/pricing-table/pricing-table-free-trial.png) ### Configure trials without payment methods To allow customers to sign up for a subscription without providing their payment method details, select **Include a free trial**, then click **Continue**. Next, select **Only collect payment method information if required**. Make sure to [set up email reminders](https://docs.stripe.com/payments/checkout/free-trials.md#collect-payment) to collect payment method information from customers before their trial ends. Otherwise, Stripe pauses the trial. ## Content Security Policy If you’ve deployed a *Content Security Policy*, the policy directives that pricing table requires are: * `frame-src`,`https://js.stripe.com` * `script-src`, `https://js.stripe.com` ## Let customers manage their subscriptions Share a link to your *customer portal*, where customers can log in with their email to manage subscriptions, update payment methods, and so on. Learn how to create and share your [customer portal link](https://docs.stripe.com/customer-management/activate-no-code-customer-portal.md). ## Present local currencies Automatically display prices in the pricing table and Checkout in your customers’ local currency by configuring [Multi-currency prices](https://docs.stripe.com/payments/checkout/manual-currency-prices.md). Use the [customer-email](#customer-email) attribute to test how your pricing table and payment page appear to customers in different countries. In the `stripe-pricing-table`, set the [customer_email](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_email) property and include a suffix of the form `+location_XX` in the local part of the email. `XX` must be a valid [two-letter ISO country code](https://www.nationsonline.org/oneworld/country_code_list.htm). ```html

We offer plans that help any business!

``` ```jsx import * as React from 'react'; function PricingPage() { // Paste the stripe-pricing-table snippet in your React component return ( ); } export default PricingPage; ``` When you view the pricing table, the currency matches the default currency of the country you specify in the `customer_email` (in this case, France). ## Add custom fields Don’t use custom fields to collect personal, protected, or sensitive data, or information restricted by law. You can add custom fields on each of your products and prices in your pricing table to collect additional information from your customers. The information is available after the payment is complete and is useful for fulfilling the purchase. You can add the following types of fields. | Type | Description | | ------------ | -------------------------------------------------------------------------------------------- | | Text | Used to collect freeform text, up to 255 characters. | | Numbers only | Used to collect only numerical values, up to 255 digits. | | Dropdown | Presents your customers with a list of options to select from. You can add up to 10 options. | ![](images/checkout/custom-fields/pricing-table.png) 1. Click **Add custom fields** in the **Payment settings** section. 1. Select a type of field to add. 1. Enter a label for the field. 1. (Optional) Mark your field as required. ![](images/checkout/custom-fields/optional.png) After your customer completes the payment, you can view the fields on the payment details page in the Dashboard. ![](images/checkout/custom-fields/payment.png) The custom fields are also sent in the [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed) event after payment completion. Register an [event destination](https://docs.stripe.com/event-destinations.md) to receive the event at your endpoint. ## Limitations * **Business models**—The pricing table supports common subscription business models like flat-rate, per-seat, tiered pricing, and trials. Other [advanced pricing models](https://docs.stripe.com/billing/subscriptions/usage-based/pricing-models.md) aren’t supported. * **Product and price limits**—You can configure the pricing table to display a maximum of four products, with up to three prices per product. You can only configure three unique pricing intervals across all products. * **Account creation**—The pricing table call-to-action takes customers directly to checkout. It doesn’t currently support adding an intermediate step (for example, asking the customer to create an account on your website before checking out). * **Rate limit**—The pricing table has a [rate limit](https://docs.stripe.com/rate-limits.md) of up to 50 read operations per second. If you have multiple pricing tables, the rate limit is shared. * **Checkout redirect**—The pricing table can’t redirect customers to checkout if your website provider sandboxes the embed code in an iframe without the `allow-top-navigation` attribute enabled. Contact your website provider to enable this setting. * **Testing the pricing table locally**—The pricing table requires a website domain to render. To test the pricing table locally, run a local HTTP server to host your website’s `index.html` file over the `localhost` domain. To run a local HTTP server, use Python’s [SimpleHTTPServer](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/set_up_a_local_testing_server#running_a_simple_local_http_server) or the [http-server](https://www.npmjs.com/package/http-server) npm module. * **Connect**—The pricing table isn’t designed to work with *Connect* and doesn’t support features like a platform collecting fees. ## Limit customers to one subscription You can redirect customers that already have a subscription to the *customer portal* or your website to manage their subscription. Learn more about [limiting customers to one subscription](https://docs.stripe.com/payments/checkout/limit-subscriptions.md).