Chapter 11. Settings Reference

Which Paddle account the site uses: Sandbox for testing, or Production for real sales. Everything PaddleSubs shows and does belongs to this environment; see the section called “Sandbox and Live Environments”.

The API key of your Paddle sandbox account, used while Environment is Sandbox. It is secret: never share it or put it in a page.

The client-side token of your sandbox account, which your pages use to show prices and open the checkout. It is meant to be seen by browsers.

The API key of your live Paddle account, used while Environment is Production. Secret.

The client-side token of your live account.

Stops PaddleSubs from calling Paddle, so you can browse the administrator pages while Paddle is unavailable. Usually turned on from the Paddle API unavailable page, or with Browse in offline mode on the Get Started page before you have a key. Importing is refused while it is on.

The secret key of your notification destination in Paddle. Every webhook is checked against it and refused if it doesn't match. Secret: never share it.

The IP addresses Paddle sends webhooks from, separated by commas or new lines; ranges and CIDR blocks are allowed. Webhooks from anywhere else are refused. Change it only if Paddle announces new addresses, or to add a relay that forwards Paddle's webhooks to your site. An empty field means Paddle's published addresses.

The addresses of a proxy, load balancer or service such as Cloudflare in front of your site. When a webhook arrives through one of them, the address it forwards is the one checked. Leave it empty if your site isn't behind a proxy: an address trusted by mistake lets anyone claim to be Paddle's address, though the secret key still has to match.

The address of your site's home page, such as https://www.example.com. Links in emails (set-password, claim, renewal and Billing Portal links, and the administrator's link to Needs Attention) are built from it, never from the address a visitor used: Joomla's scheduler can send emails during any visit, and a forged address would send customers' links to someone else's site. PaddleSubs fills it in the first time an administrator opens one of its pages, from the address used to sign in. Check it, and change it if your site moves to another address. When Joomla's $live_site in configuration.php is set, that is used instead.

Until it is known, an email with links is not sent from a visit: it is tried again at a later run, after an administrator has opened a PaddleSubs page.

The language whose conventions administrator pages and the Sales Graphs use to format numbers and amounts, such as 1,234.50 or 1.234,50. Empty means the administrator's language.

How dates are written in the administrator lists of Access Subscriptions and transactions, in PHP's date format: Y-m-d H:i gives 2026-10-03 14:30, d/m/Y gives 03/10/2026. Site pages use the date format of the visitor's language.

Prices on your pages are always shown before tax. With this on, two lines under each price add the tax Paddle estimates for the visitor's location and the total they would pay, such as “+ CA$19.37 estimated tax” and “CA$168.37 in total”; nothing is added where Paddle estimates no tax. Turn it off to show the price alone. The checkout always shows the exact tax.

Shows the field where customers enter a discount code in Paddle's checkout. Paddle shows it only when Allow buyers to add a discount code is also on in Paddle → Checkout → Checkout configuration, and accepts only discounts with a code that are enabled for checkout. Turn it off if you don't hand out codes; discounts PaddleSubs applies by itself, such as relation and bundle discounts, still apply.

Whether Paddle's checkout can show customers prices in their local currency, which Paddle calls automatic currency conversion and sets in its currency settings. PaddleSubs can't read that setting from Paddle, so set this to match it. While it is on, every discount of a fixed amount carries a warning when you edit or save it, because Paddle applies a fixed amount only to checkouts in the discount's own currency (Discount Type and its amount). It changes nothing in the checkout itself.

Whether PaddleSubs loads its own copy of Bootstrap 5 on its site pages. Joomla's own templates load Bootstrap 5, so leave this off with them. Turn it on if your template doesn't, and the pages look unstyled. The copy styles only what is inside PaddleSubs' pages, so the rest of your site keeps its look. It loads before your template's styles, so the template can still change the pages.