FAQ

Does this slow my pages down?

No. Pages read the prices from your own database, and your server never calls Freemius while a visitor is waiting. A stale copy renders as it is and schedules a background refresh.

How quickly does a price change appear?

With the webhook registered, within seconds. Without it, within the time set in Refresh after on the Settings screen, which starts at 15 minutes, and at worst within a day on a page nobody visits.

What happens if Freemius is down, or my token stops working?

The last prices fetched stay on your pages indefinitely, and an admin notice tells you the refresh is failing. Nothing goes blank and nothing invents a figure.

Do I have to set up the webhook?

No. Saving a product with a working token registers it for you and every later save checks it. See Getting started for what the Status card says when Freemius has not enabled webhooks for a product yet.

Do I need Freemius's own WordPress plugin as well?

No. This plugin talks to the Freemius API directly and depends on no other plugin. The two run side by side happily. The only thing this one does to the rest of your page is add the visitor's currency to links pointing at the Freemius checkout, whoever made them.

Where do I get the API Bearer Authorization Token, and is it safe?

In the Freemius dashboard: the product, then Settings, then Keys. It is stored in your site's settings, shown masked, never written to the log, and sent nowhere but api.freemius.com over HTTPS from your server. The product secret key is read with it, so there is nothing else to copy.

Which currencies are supported?

The ones the Freemius pricing API returns: USD, EUR and GBP. The plugin never converts a price, so a currency a plan has no row in is never offered for it. See The visitor's currency.

Do I have to write out every attribute?

No. Every attribute on every shortcode is optional, and the shortest form is the right one: [pflp_price] renders your headline price and [pflp_button] links to the checkout that sells it. See Reference for what each default resolves to.

Can I show prices for more than one product?

Yes. Add each one on Freemius Pricing, Products, then name one with product="12345", or with its Freemius slug or name. The first product configured is used when a shortcode names none.

The product was renamed in Freemius. When does the site follow?

The name comes with the prices on every fetch, and Freemius sends no webhook for a rename, so it follows on the next refresh, or straight away if you press Refresh now or save the product.

What about the free plan?

Nothing from this plugin: a plan with no price has no figure to show and no checkout to link to. Use an ordinary button, the core Buttons block or your theme's, linking to the plugin's download page. That link is a fixed fact rather than a live price, so there is nothing to keep current.

Are there blocks, or only shortcodes?

Both, and they are the same code, so they can never disagree. Seven blocks under Widgets in the inserter, the Freemius pricing card among them, and the card again under Freemius in the Patterns tab, ready sized and bordered. A Shortcode block converts to a block in one click, and back again; what does not survive the trip is on Styling.

Does it work with a page cache?

Yes. Every price is written into the page in all of its currencies and all of its billing cycles, and both swaps happen in the visitor's browser, so a cached page is the same page for everyone.

Does it replace my buy buttons?

Only if you want it to. A button you built yourself works just as well: the plugin adds the visitor's currency to any link pointing at the Freemius checkout, and can open it in an overlay. See Buy buttons.

Can it show the current version and the money-back guarantee?

Yes. The Freemius release block, or [pflp_release], shows the latest version released on Freemius, what it requires and what it is tested up to, and the Freemius money-back block, or [pflp_moneyback], shows the guarantee set in the dashboard. Both update when you release or change them, the same way prices do. A product with no releases on Freemius, such as an app, shows no release line at all, and a product with no money-back period shows no guarantee: there is no typed fallback, because a typed version is the copy that goes stale. See The release line and The money-back guarantee.

What external services does this plugin use?

The Freemius platform. Your server reads your prices, your money-back period and your latest release from the Freemius API, sending the product ID and your token and nothing else, and only when you refresh, test a token, receive a webhook or a scheduled refresh runs. The visitor's browser asks checkout.freemius.com which currency to show, sending nothing beyond the request itself, and keeps the answer for an hour. With the overlay checkout on, their browser also loads the Freemius checkout script. Webhooks run the other way, inbound, and each is checked against both the key in its URL and the signature on its body. Nothing about your visitors is ever sent to Freemius by your server. Freemius's terms are at https://freemius.com/terms/ and its privacy policy at https://freemius.com/privacy/.