--- title: "Creating a Payment Page with our Builder" description: "Build a more powerful course or digital product checkout" url: https://help.teachery.co/en/articles/240-creating-a-payment-page-with-our-builder collection: "General" updated: 2026-10-14 language: en --- # Creating a Payment Page with our Builder Build a more powerful course or digital product checkout Our new payment pages focus on offering **more functionality** than our original template - and is especially suited for [digital product downloads](https://help.teachery.co/en/articles/229-quickly-sell-a-digital-download-with-teachery.md#heading-0-using-the-payment-page-builder). If you’re new to the _Payment Page Builder_, we recommend **giving** [**this introductory help doc**](https://help.teachery.co/en/articles/241-introducing-the-payment-page-builder.md) **a read first** (it will be handy throughout your build too). And then let’s get you building! Below is a breakdown of how to get started and the high-level settings available to you throughout the build of your payment page. You can create a clean, brief, elegant payment page (like the one pictured below) or [one with more _bells and whistles_](https://live-demo.teachery.co/demo-teachery-payment-page-new) (including your own custom CSS). ![](https://staticfiles.gleap.io/ghelparticle/16W8wHUXSyTL2nQtzsGJZ4cYt6pMeWFxXIMgRZeEt5XikwMlxW21WCLi9ua3RPAgaC5630AeWpi.jpeg) ## Create a Payment Page Much like with our [traditional payment pages](https://help.teachery.co/en/articles/212-creating-a-payment-page-and-editing-your-default-payment-page.md), create or find the course in which to host the payment page and click into the course to edit it. In the _Payment Pages_ section of the left sidebar menu, click **\+ Add Payment Page**. Select our new _Payment Page Builder_ in the popup that appears. (If you’d prefer to stick to our original template, please visit [this help doc](https://help.teachery.co/en/articles/212-creating-a-payment-page-and-editing-your-default-payment-page.md) instead.) > **Info:** **Tip:** Name your payment page clearly - it will make it easier to find if you happen to have a lot of payment pages either within a single course/product or across all courses/products. You can update this within the payment page’s _Settings_ tab (and then jump into _Page Settings_). > **Warning:** If you choose to use our _Stripe_ integration to process payments, please ensure you’ve [connected your _Stripe_ account](https://help.teachery.co/en/articles/211-using-teacherys-built-in-payment-method-stripe.md) **before** creating your final payment page. If not, you will be unable to define some settings (e.g. price and currency) and may need to create your payment page from scratch once you have connected the two tools. ![](https://staticfiles.gleap.io/ghelparticle/83AUc6cRagVwTXcXjSo8sZMxfiLzCcaNjUASgyo3z65EuYwh0cox33Sou5s9uGAUkOjEOeJAxtQ.png) ## Product > **Info:** We currently only support the following currencies: **$** - US Dollar, **€** - Euro, **MXN** - Mexican Peso, **£** - Pound Sterling, **₹** - Indian Rupee, **AU$** - Australian Dollar, **NZ$** - New Zealand Dollar, **C$** - Canadian Dollar, **DKK** - Danish Krone, **SEK** - Swedish Krona. - **Details**: Including product title, pricing model, currency, and any discounting/promotional pricing. Please see our [_Prices and Payment Options_](https://help.teachery.co/en/articles/241-introducing-the-payment-page-builder.md#heading-2-prices-and-payment-options) section for more. - **Description**: For you to explain your offer (additional images can be included here) and has a character limit of 3,000. - **Image**: With a one image limit. Recommended dimensions are 1280 x 720 \[4:3\] and please note that, currently, full-width images are **not** possible (this template is a two-column page format). - **Variants**: If you choose to offer multiple pricing options in the _Details_ tab, the in the _Variants_ tab is where you can define the different payment options you’d like to offer, e.g. $20/month or $200/year. - **File Downloads**: With an option to upload one or more files using our [built-in file manager](https://help.teachery.co/en/articles/172-uploading-files-pdfs-and-other-downloadable-content.md) (many different formats are accepted but the maximum file size is 50MB). Once uploaded, it’s possible to then **select or deselect** the files you’d like to link to this payment page (read more about [how customers access their files](https://help.teachery.co/en/articles/241-introducing-the-payment-page-builder.md#heading-5-how-customers-access-downloads), etc.) i.e. a deselected file will **not** be made available to a customer who uses that payment page. > **Error:** Deleting a file will delete it from the course and from any payment page within that course. Please consult these [**other important points**](https://help.teachery.co/en/articles/241-introducing-the-payment-page-builder.md#heading-1-important-to-know) regarding downloadable products. - **Gifting**: If you want to enable customers to buy this course/product as a gift for others, you can enable this functionality in this tab and, to some extent, manage the text/field labels that your customers will see. In the **_After Payment > Confirmation_** tab, you will be able to insert text that the buyer will see on successful checkout. Note that, if a user chooses to make a gift purchase, this confirmation screen will override your standard confirmation screen. [**Learn more**](https://help.teachery.co/en/articles/218-gifting-a-course-or-product.md#heading-2-what-happens-after-a-gifting-purchase) about what happens at/after a gift purchase. > **Warning:** **Important**: Any custom checkout fields added in the _Checkout > Checkout Fields_ section of our new payment pages will **not** apply to gift purchases. > > A **workaround** for when you need customers to **accept your terms and conditions** during a gift purchase: In the _Product_ > _Gifting_ section, you can edit all the language of the gifting fields and include, for example, in the “_Gifting option checkbox text_” field, a hyperlink to your T&Cs. A rough example of what you can include in that field: “**Yes, I'd like to buy this as a gift. By proceeding, I accept the Terms and Conditions.**” ## Checkout - **Checkout Fields**: Enabling you to add multiple fields to capture customer information and even opt-ins e.g. a checkbox in which customers have to accept your [terms & conditions (T&Cs) / policies](https://help.teachery.co/en/articles/166-gdpr-compliance-and-adding-your-own-privacy-policy-and-terms-to-teachery-payment-pages.md#heading-2-want-a-checkbox-we-have-you-covered) (select _Terms_ as your field’s _Data Type_ 😉 and drop some context into the _Label_ and, optionally, include a URL to your terms in the designated space but most definitely make this field **_required_**). Be sure to **set your _Data Type_** for every additional field you add (except for a multiline field - you can leave **_Data Type_** undefined for those). Customers’ first name, last name, and email addresses are the minimum required fields. If enabled, [_Stripe Tax_](https://help.teachery.co/en/articles/242-using-stripe-tax-in-payment-pages.md) will automatically display additional fields (and will override any of yours that intend to capture the same info - read more [here](https://help.teachery.co/en/articles/242-using-stripe-tax-in-payment-pages.md#:~:text=payment%20page\(s\).-,Checkout%20Fields,-Note%20that%20once)). To make use of conditional logic, we recommend first creating all your fields (_before_ setting any of them as _required_) and only then enabling and setting the conditional logic of the specific fields you want to show/hide as needed. Any custom fields added here will **not** apply to gift purchases. > **Warning:** **Important**: The data captured in custom checkout fields is recorded in your [customer CSV export](https://help.teachery.co/en/articles/135-download-course-data-and-export-customers.md#heading-1-how-to-download-by-individual-course) (at individual course level). The “_Terms_” field type is the one exception but we strongly recommend setting this field to required. You can then confidently assume that anyone who signed up also accepted your terms and conditions. Please also see note above regarding gift purchases. - **Promo Codes:** Enabling you to accept promo codes or coupons (see our [dedicated help doc](https://help.teachery.co/en/articles/216-setting-up-promo-codes-or-coupons.md) on how to create and manage these). - **One-click Upsell**: Set up an upsell (a.k.a order bump) to display on your payment page. See our [dedicated help doc](https://help.teachery.co/en/articles/175-introduction-to-upsells-and-course-bundles.md) on how to create and manage upsells. You can only add **one** upsell and it must be in the **same currency** as your payment page. > **Warning:** **Important:** If any course, product, or hub in your upsell is also making use of our new _Payment Page Builder_ to sell file downloads, be sure to: select the relevant payment page housed within _that_ course/product while still in the _One-Click Upsell_ section of your payment page setup (see image below); else customers cannot access that course’s/product’s dedicated **_Downloads_** page. > > **Advanced**: once you have an upsell set up on a payment page, you can choose to have it preselected by default - learn more [here](https://help.teachery.co/en/articles/176-use-upsells-to-sell-a-course-bundle.md#heading-7-advanced-upsell-tip-pre-check-the-upsell). ![](https://staticfiles.gleap.io/ghelparticle/inhXidhuaXhTipznvyXOk6awNOZSf0EZMpF8kYC7C54v42FWqdwRiHcllekhhX2d9gdcZKsDjnx.png) - **Payment Methods**: See our [dedicated section](https://help.teachery.co/en/articles/241-introducing-the-payment-page-builder.md#heading-3-payment-methods) on payment methods. Please note that until you have a Stripe account connected, this tab may not be visible. - **Stripe Tax**: To help you calculate and collect the tax on your sales (_Stripe Tax_ requires additional setup - please [see this guide](https://help.teachery.co/en/articles/242-using-stripe-tax-in-payment-pages.md) for more). Please note that until you have a Stripe account connected, this tab may not be visible. > **Info:** Teachery is **not** a _Merchant of Record_ (nor tax experts 😅). You remain responsible for all tax collection, compliance, remittance, etc. ## Design - **Colors**: Define primary text, background, and button colors. Note that, to ensure consistency, your choice of button color will be applied to elements on, for example, your payment confirmation page too. > **Warning:** **Important**: The _Description_ field (in the _Product_ tab) has its own text editor with a color selector. A color set in the editor overrides the color in your design settings. - **Custom CSS**: The _Payment Page Builder_ offers limited styling out-of-the-box. Introduce your own custom CSS for more customisation. See our [dedicated help doc](https://help.teachery.co/en/articles/243-custom-css-tricks-payment-page-builder.md) on custom CSS. > **Warning:** We can't ensure support for any custom code you add. We'll do our best to help, but know that custom code can cause issues if not added properly. **Proceed at your own risk!** Please be sure to preview your page (ideally, in an incognito/private browser tab) to ensure everything is working and appearing as it should. - **Custom Labels**: Use this area to translate some of the payment page text to a language other than English. ## After Payment > **Info:** We don’t currently enable the addition of post-checkout upsells or tripwires. This is on our radar for future. 😉 We do, however, enable you to redirect customers to any internal or external page after successful checkout. On successful purchase, you can either: 1. send a user **directly into your course**, or 2. display a **confirmation message**, or 3. display your own **customised confirmation message**, or 4. **redirect** your user into another Teachery course page (select the “Next Page” option) **or** to an external URL (select the “Redirect to URL” option). Here’s a little more info about your after-payment options/settings: - **Confirmation > Confirmation Messages**: Choose to either use our **default** **confirmation message** **or write your own custom** **message**. You can insert dynamic product, customer, and payment info into your **custom** message by clicking the **\+ Add Variables** button. If you’ve added any additional fields in the _Checkout_ tab of your payment page, these will also now appears as “variables”. If you’re selling a download(s), you can choose to either display the file(s) as a **list** (which customers can immediately download on successful purchase) or display a **button** which will direct customers to your _Downloads_ page. [Learn more here](https://help.teachery.co/en/articles/241-introducing-the-payment-page-builder.md#heading-5-how-customers-access-downloads) about how this experience differs. > **Info:** We recommend keeping your **custom** messages simple and brief. The customer will still receive a [welcome email](https://help.teachery.co/en/articles/152-setting-up-your-welcome-email-and-course-completed-email.md) in which you can provide more info. - **Confirmations > Gift Purchases:** You will only see and be able to update this section **if you enabled gift purchases** in the _Product > Gifting_ tab. You can insert the text you’d prefer for users to see on successful checkout and make use of special placeholders/merge tags that will automatically populate the buyer’s email address, the gift recipient’s email address and the date on which they will receive their welcome email. - **Integrations**: If you use [Mailchimp](https://help.teachery.co/en/articles/146-integration-with-mailchimp.md), [MailerLite](https://help.teachery.co/en/articles/231-integration-with-mailerlite.md), [Kit](https://help.teachery.co/en/articles/159-integration-with-kit-formerly-convertkit.md), or [Flodesk](https://help.teachery.co/en/articles/230-integration-with-flodesk.md) as your email provider, use this area to connect them to your checkout process. ## Settings > **Warning:** We can't ensure support for any custom code you add. We'll do our best to help, but know that custom code can cause issues if not added properly. **Proceed at your own risk!** - **Email Notifications:** Enable this if you’d like to receive an email every time a sale is made. - **Custom Code**: A space for you to add custom code to the tag of a payment page. ⚠ Proceed at your own risk. - **Tracking Conversions**: See our conversion tracking guide [here](https://help.teachery.co/en/articles/187-conversion-tracking-facebookmeta-pixel-and-other-successful-payment-page-items.md#heading-2-option-2-all-other-conversion-tracking-software-google-analytics-gosquared-fathom-etc). - **Facebook Pixel**: See our Meta Pixel guide [here](https://help.teachery.co/en/articles/187-conversion-tracking-facebookmeta-pixel-and-other-successful-payment-page-items.md#heading-0-option-1-adding-your-facebook-meta-pixel-for-pageviews-and-conversions). - **Page Settings**: Manage your payment page’s URL/link and page name (which will appear in the left sidebar menu when you’re editing the course). - **Google Index**: If you’d like your payment page to be discoverable by Google’s search engine, you can enable this here. It’s **disabled** by default. - **Countdown Timer:** Use this feature to set a deadline on your payment page. Visit the _Expiry Settings_ tab to define the text you want to display to customers once the countdown timer has expired or, alternatively, you can enable a redirect to kick in on expiry. To make checkout available again, simply disable the toggle in the _Countdown Timer_ section of the payment page. - **Quantity Limit:** Limit the number of sales or enrolments you will accept. Refunded purchases are not counted toward this limit. Visit the _Expiry Settings_ tab to define the text you want to display to customers once the limit has been hit. To make checkout available again, simply increase the quantity in the _Quantity Limit_ of section of the payment page. When a limit is hit, you will be notified by email. - **Expiry Settings:** Set the message your customers will see when either you hit your defined sales limit (see _Quantity Limit_ above) or if you enabled a countdown timer that has hit its deadline. If you instead want to redirect customers on expiry, you can set your URL here too. To un-expire a payment page and make checkout available again, simply adjust your sales limit and/or countdown timer (see above.) ## Test Mode > **Warning:** **Important:** If you’ve shared your payment page URL with customers and they happen to visit it while it’s in _Test Mode_, they too will be able to see and use _Test Mode._ > > **No** real **payment nor enrollment** will take place when using _Test Mode_. To get a better feel of your payment page’s checkout experience (especially immediately _after_ purchase), you can turn on _Test Mode_. Look for the the _Test Mode_ toggle in the top right section of your _Payment Page Builder_. _Test Mode_ simply helps you get an idea of what the checkout workflow looks like. It **doesn’t** capture any real **payment nor enrolment**. We still **strongly recommend you make a real purchase** to test things thoroughly (see the next section). ![](https://staticfiles.gleap.io/ghelparticle/5A7JhSFKifYLuWTsc14EJJ0C5MknR8rsPfahtONKRwzIlIcnAK7VfvSrig6T97IKpWuSxYfoIvH.png) You can simulate a real purchase (without processing a real payment) either directly in the preview panel or, alternatively (and recommended), copy your page’s URL and open it in an incognito/private window to complete a test purchase. (Use the test card number provided and any expiry date and CVC number.) ![](https://staticfiles.gleap.io/ghelparticle/uIRJ5txGpkkbToVM4S2Efwbvv6PmrMEUKZwXEBwIMYlyie7YBfKQ5wtzmDKZWoBpEJpfLFm29cU.png) ## Recommendation: Test Your Payment Pages Despite offering _Test Mode_ (see above), we still cannot stress this recommendation enough: If you want to see the exact experience (you and) your customers will have (and to ensure that taxes are being captured correctly or email provider integrations are working), **making a real purchase** of your own course/product **through a payment page** will be useful. You will get to see both sides of the transaction and ensure everything is working as it should. > **Warning:** When you do attempt a real purchase through your payment page, switch to **another browser or incognito mode** and be sure to use an email address that is **NOT** your course-creating Teachery account email address (use, for example, any other personal email address you might have). - Click the **Share URL** button in the top right of your payment page - Open that link in an **Incognito** or **Private Window** - Put the payment page to the test (e.g. if you have multiple payment plans available, confirm the page reflects your selection) and **complete the checkout** If you want to [refund your purchase](https://help.teachery.co/en/articles/129-revoking-access-refunds-deleting-customers-and-other-customer-actions.md#heading-4-refund-course-payment) at any point, you can do so via your test customer’s _Customer Profile_ via the _Customers_ page. > **Error:** _Stripe_ (or your chosen payment processor) will, like in any standard transaction, still charge you fees and refunding does not reverse these. Instead of making a full payment, you can create yourself a 100%-off promo code just for testing purposes (be sure to make it a tricky promo code and/or consider limiting it to one use). But we still **strongly recommend placing an order with a real payment** to ensure welcome emails, Stripe receipts, refunds, taxes, etc. are all rendering/working as they should. ## More Important Help Docs With some high-level understanding of what to expect, we think you’re ready to start building. Here are some additional guides to read and bookmark: 1. [Introducing the Payment Page Builder](https://help.teachery.co/en/articles/241-introducing-the-payment-page-builder.md) 2. [Using Stripe Tax in Payment Pages](https://help.teachery.co/en/articles/242-using-stripe-tax-in-payment-pages.md) 3. [Custom CSS Tricks: Payment Page Builder](https://help.teachery.co/en/articles/243-custom-css-tricks-payment-page-builder.md) 4. [Sell a Digital Product Download **Only**](https://help.teachery.co/en/articles/229-quickly-sell-a-digital-download-with-teachery.md#heading-0-using-the-payment-page-builder)