Getting started

Five minutes, most of it in the Freemius dashboard.

1. Install and find the menu

Activate the plugin. Freemius Pricing appears in the WordPress admin menu, with Products, Settings, Appearance and Logs under it. It opens on Products, which is empty to start with. Once a product is added, the row shows what the plugin knows about it.

2. Get the product ID and the token

In the Freemius dashboard:

1. Open the product you want to show prices for.
2. The numeric product ID is in the URL and at the top of the product's own pages. Copy it.
3. Go to Settings, then Keys.
4. Copy the product's API Bearer Authorization Token.

That token reads the product's plans and prices and cannot change them. Nothing about your visitors is ever sent to Freemius by your server.

3. Add the product

On Freemius Pricing, Products, press Add product. The Add screen is one card with two fields:

1. Product ID - the number you copied. It is fixed once added, because it is how everything stored for the product is filed; to use a different one, delete the product and add it again. There is no name to type: the product's name and slug arrive from Freemius with the first fetch.
2. API Bearer Authorization Token - paste it in. The field is masked, and the eye button beside it shows the value if you need to check a paste.

Press Test token. It reports the product's name, its plans and how many pricing rows came back, or exactly what Freemius said if the token was refused. Then press Add product.

The save fetches the prices and the product's name, reads the product secret key with the token, and registers this site's webhook with Freemius. You land on the product's own screen.

The secret key chip

Under the token, the Product card carries a chip reading Secret key on file or Not fetched yet. The secret key signs every webhook delivery, so a delivery can be proved genuine. There is nothing to type: it is read with the token on every save.

The Status card

The side column tells you where the product stands:

• Prices - how many plans, how many prices and which currencies came back, and when they were fetched. Refresh now underneath fetches again.
• Release - the latest version released on Freemius and the date it reached Freemius, such as 1.4.0, released 2 September 2026, or None published on Freemius for a product with no WordPress releases.
• Money-back - the money-back period Freemius holds, such as 30 days, or None set on Freemius.
• Webhook - a chip reading Registered with Freemius, Not registered yet, Not registered or Not enabled by Freemius for this product, then the last delivery and the event that came with it.
• Last error - None, or what went wrong and when.

Nothing has to be done about the webhook: saving the product with a working token registered it, and every later save checks it is still there and subscribed to the right events. Show webhook URL underneath opens the URL, a Copy button and the events it listens for, for checking against the Freemius dashboard under the product, then Webhooks, then Listeners.

If the chip reads Not enabled by Freemius for this product, Freemius has not unlocked webhooks for it yet: it reserves them for products that are actively selling, and the dashboard cannot add one either. The save is complete and the prices are live; every later save tries again, so the webhook appears by itself. If it reads Not registered, the call failed and the line says why; the disclosure opens by itself with instructions for pasting the URL in by hand.

Treat that URL like a password. It carries a key your site generated, and it is half of what proves a delivery is genuine.

4. Build your first shortcode

The Shortcode builder on the same screen is four dropdowns and a code box.

1. Element - Pricing card, Price, Buy button, Plan name, Plan description, Features list, Currency toggle, Billing cycle toggle, Release line or Money-back guarantee.
2. Plan, Licences and Billing cycle - each one's first entry names what the default works out to for your product, for example Default (Yearly), and each list offers only what the one above it sells. A dropdown that cannot affect the chosen element is greyed out rather than hidden.

The code box shows the shortcode as you go, with anything left at Default left out, so the shortest working form is what you get. Copy takes it, and the line underneath says what it renders, for example "Renders $25 (3 licences, annual) in the visitor's currency." A Every price this product sells disclosure at the foot of the card lists every row the API returned, one line each.

Paste the result into a page, a widget area, a page builder or a template file. Every attribute is optional, so [pflp_price] and [pflp_button] on their own already render your headline price and the checkout that sells it.

Release line and Money-back guarantee are facts about the product rather than a plan, so the plan, licence and cycle dropdowns grey out for them. The release line has a Show list of its own: Version, Requires, Tested up to and Released, the first three chosen to start with. Hold Cmd (Ctrl on Windows) and click to add or take one away. If Freemius has no releases for the product, the line under the code box says so, and so it does for a product with no money-back period. Both are covered in The release line and The money-back guarantee.

Or insert a block

In the block editor, open the inserter and look under Widgets, or type "Freemius" into its search box. There are nine blocks: Freemius pricing card, Freemius price, Freemius buy button, Freemius plan text, Freemius plan features, Freemius currency toggle, Freemius billing cycle toggle, Freemius release and Freemius money-back. Each one renders your headline row the moment it is inserted, and its sidebar offers only the combinations your product sells.

Start with the card. Insert Freemius pricing card and it arrives holding the plan's name, its price, its description, its features list and a full-width buy button, every one of them live and every one of them still its own block. The card itself has a Width, a Position and the border, colour, padding and spacing panels, on every theme.

A pricing row is three choices. Put a Columns block on the page, drop a card into each column, and set each card's Plan once, in its What this card is about panel. Everything inside a card follows the card, so you do not touch the blocks inside at all. The plan you mark featured in the Freemius dashboard marks its own card automatically: a badge, a border, a background and a shadow, all set once on the Featured plan tab under Settings.

The pricing card has the tour.

A Shortcode block holding any of these shortcodes converts to the matching block in one click, and the block type menu converts a block back.

5. Set the site-wide options

Freemius Pricing, Settings holds the choices that are not per product, on two tabs. The Settings tab is what a price says and how it behaves; the Appearance tab is how every toggle, card and buy button looks. Each has its own Save, and saving one never changes anything on the other.

Display

• Default currency - the currency written into the page before the visitor's browser picks one.
• Remember the choice - whether a visitor's currency choice is kept in their own browser.
• Checkout - the hosted Freemius checkout page, or an overlay over your own.
• Refresh after - how stale the stored prices may get before a page view schedules a background refresh. It is the backstop for a webhook that never arrived, not a polling interval.

Billing cycle

• Default cycle - which cycle a price shows first. A plan that does not sell it shows the first one it does.
• Toggle labels - the words on every billing cycle toggle. Monthly, Yearly and Lifetime to start with.
• Text after the price - /month, /year and one-time to start with, printed only where a price asks for them with suffix="auto". Nothing you have already published changes.

Buttons

• Button label - the words on every buy button without a label of its own.

Appearance, the next tab along and an entry of its own in the sidebar, has a live card, both kinds of buy button and both toggles beside its fields, redrawn as you change them.

Toggles

• Style - the look every currency and billing cycle toggle takes: Pills, Buttons, Tabs, Text or Switch. Unchanged leaves them as plain buttons your theme styles.
• Colours - Normal and Active columns, Text and Background rows: every option at rest, and the one a visitor is on. Leave one empty and the style's own stays. A toggle that names its own style or colour keeps it, and Size and Gap stay on each toggle because they are layout.

Cards

• Hover lift - how far every pricing card rises under the pointer, 0 to 6 pixels. 0 is none. A card already raised for being featured rises further rather than dropping back.
• Hover shadow - none, soft or strong, the shadow it takes under the pointer. A featured card keeps its own shadow at rest and takes this one while the pointer is on it. Both apply on screens 1025px and wider only.
• Shadow colour - the colour that shadow is drawn in. The preset keeps its depth and its softness and only the colour changes. Empty is the neutral black, and with Hover shadow on None there is nothing to colour.

Buttons

• Button classes - extra CSS classes for every button.
• Hover lift - how far every button rises under the pointer, 0 to 6 pixels. 0 is none, 1 is the house look.
• Hover shadow - none, soft or strong, the shadow it takes with it. Both apply on screens 1025px and wider only.
• Shadow colour - the colour that shadow is drawn in, the same way it works for a card.

Filled buttons and Outlined buttons, a group each, one for each kind of button:

• Border width - 0 to 20 pixels. A filled button has no border unless you set a width; empty keeps your theme's, which for an outlined button is its 2px outline. 0 takes the border away. A Border colour never creates a width: it colours a border the button already has.
• Colours - the text, the border and the background that kind takes Normal and On hover. An outlined button's Background is empty to start with, which is what makes it outlined. Leave a colour empty and your theme's own stays. A colour set on the button itself wins over the Normal column, and unlike the lift and the shadow, these apply on touch screens too.

Featured plan, a tab of its own after Appearance, says how the plan you feature in the Freemius dashboard is marked out, in three groups: Card (border, background, shadow, a small lift), Badge (where it sits, what it says, how big it is, an optional icon and its two colours) and Button (the buy button's text, border and background, at rest and under the pointer). A real card beside the settings redraws as you change them.

Leave a colour empty and being featured does not change it: the card keeps the border, background and button colours it already has, so you paint only what you choose to paint. The badge is the exception, because it has no colour of its own to keep, and left empty it takes the card's text colour with its words in the card's background.

6. Check it

Open the page as a logged-out visitor. You should see the current prices in the currency for where you are: from a desk in the UK you see the GBP figure even though the dashboard's plan table reads in USD, because the choice is made in the browser (see The visitor's currency). Press the billing cycle toggle and every price, suffix and buy button on the page should move together.

Then change a price in the Freemius dashboard and reload within half a minute. The new figure should be there, with no visit to the editor.