Changelog

Following feedback from our makers community, we are releasing several improvements to the customer invoices this week.

Better Invoice Header

For SaaS & Apps, it didn’t make sense to include the slug of a product in the invoice title. While the slug helps identify WordPress products, it only added confusion for other product types. With this change, the invoice header is now cleaner and more relevant for SaaS & Apps.

Smarter Product URL

We’ve made the product URL smarter in the invoice. It will now first try to use the URL from the product settings.

If no product URL is defined, it will fall back to the store URL and, finally, to the maker’s billing information. This makes the invoice better aligned with the actual product context, instead of defaulting to the general billing address as before.

Dynamic License Unit Labels

We noticed a bug where the item description wasn’t showing custom license unit labels for App & SaaS product types.

This has now been fixed, ensuring that invoices clearly display what the customer purchased, with accurate and dynamic unit labels.

This week we’re rolling out several quality-of-life improvements and bug fixes to the Developer Dashboard.

Store Icon Update Bug Fix

We noticed an edge-case bug where updating the store icon sometimes reverted it back to the default one.

This issue has now been fixed, ensuring your store icon remains exactly as configured.

Fixed Labels in the Coupon Configuration Pane

We found that certain labels, such as “One-off” for one-time purchases, and the dynamic unit labels, were not being displayed correctly in the coupon configuration pane.

A fix has been deployed, and the UI now properly reflects your configuration—removing confusion around pricing units and coupon applicability.

Fixed Events Filtering in the Stores Page

We also addressed a bug where filtering by status did not work correctly for events listed under the Stores page.

Filtering now works as expected, making it easier to locate relevant event data at a glance.

Improved Onboarding Experience

To make onboarding even smoother, we’ve added a new video walkthrough to the Developer Dashboard. It appears when a product setup hasn’t yet completed its critical steps.

The walkthrough demonstrates how quickly and easily you can integrate any type of product with Freemius and highlights the setup checklist page—helping makers complete their integration process efficiently.

We’re excited to share the official release of the Freemius for WordPress plugin — a community-built initiative by Xaver, the creator of Mailster. Developed independently and supported by Freemius, the plugin makes it incredibly easy to integrate the Freemius Checkout and other components into your WordPress site. Watch the short video below to explore its features.

If you’re selling your WordPress product with Freemius, then besides the built-in WP SDK Checkout, we’ve always recommended embedding a pricing page on your own marketing website using the Freemius Checkout JS SDK. However, this required writing and maintaining the integration code manually.

With the Freemius for WordPress plugin, you no longer have to. If your theme supports blocks, you can turn any button into a Freemius Checkout button and configure all available options right from the editor. You can also integrate Freemius Checkout with any pricing table or layout pattern that comes with your theme.

To make this even easier for our makers, we’ve added a new step in the Setup Checklist inside the Developer Dashboard that explains the plugin’s role and how it fits into your setup.

Additionally, you’ll now find instructions for using the plugin inside the Get Checkout Code dialog accessible from the Plans page.

You can learn more in our documentation.

Even if your product itself isn’t built on WordPress, as long as your marketing site runs on WordPress, you can use this plugin to easily integrate Freemius Checkout and other components.

We’re just getting started with this plugin. In upcoming releases, we plan to introduce more features such as embedding the Customer Portal, providing SSO login options, and unifying all these capabilities into a single, robust plugin for WordPress makers.

Freemius’ robust licensing system allows activating a license on a WordPress product that isn’t owned by the website owner. This is particularly useful for agencies that manage client sites, as they can install and manage licenses on behalf of their clients. To maintain privacy, agencies often enable whitelabel mode to hide license keys and other sensitive information from the WordPress SDK.

However, depending on how the client initially installed the product, the same license could sometimes appear as a “foreign license” under the client’s own Customer Portal account.

In such cases, the portal previously displayed the license and allowed actions like upgrading the plan or updating the payment method—actions that should have been restricted.

In this week’s deployment, we’ve addressed and fixed this privacy issue.

Now, license keys associated with foreign licenses will remain hidden. The only available action for clients will be to change the license, matching the limited actions available from within the WordPress SDK.

We appreciate our makers for reporting this. While the issue posed no direct security risk, it did raise valid privacy concerns, especially in agency-client setups.

Our Customer Portal includes an upsell section that helps nudge customers to purchase additional licenses. When customers view an installed product under their website, they can see their license utilization and, right beside it, have the option to buy more licenses.

Some makers shared that when opening and closing the checkout from this upsell button, the exit intent UX was being triggered — which felt counterintuitive since the flow was designed to encourage purchases.

Taking this feedback into account, we’ve now disabled the exit intent coupon behavior in the Customer Portal, ensuring a smoother and more intentional upsell experience.

This week we’re super glad to announce the immediate availability of our fully redesigned customer emails, refreshed with new brand guidelines and a modernized layout.

If you’ve customized your email design and would like to update, scroll down to the “Migrating From the Old Design” section below.

Since the beginning of this year, we’ve been gradually refreshing legacy designs across Freemius, and today marks another huge milestone.

We had already kickstarted the email rebranding earlier and completed the redesign of all maker-facing emails. Starting today, all customer-facing emails have also been fully rebuilt — and the new design continues to offer the same rich Email Customizer experience you’re familiar with.

The new email designs bring a cleaner, more modern experience for your customers. We’ve taken special care to emphasize key CTAs (call-to-actions) and improve the visual hierarchy with clear section headings for better readability.

You can explore the new design right now by going to Email Style Customization under your store settings.

Migrating From the Old Design

If you’ve previously customized your email design, you won’t be automatically upgraded. But upgrading is simple and takes just one click.

1. Go to Store → Emails
2. Open the Customization tab
3. Click the “Upgrade Design” button

All your existing customizations will be automatically migrated to the new system, making the transition seamless.

If you prefer the older style, you can click the “Switch Back to Legacy” button at any time to revert—without losing your configuration.

Please note that while the legacy design will remain temporarily available, we plan to phase it out soon.

We encourage you to migrate early to take advantage of the new design improvements. If you have any questions or encounter any issues, please reach out to our support team—we’ll be happy to help.

Today we’re releasing version 0.1.0 of our JavaScript SDK. We’ve received valuable feedback from our makers, and this release focuses on addressing those, fixing a few bugs, and improving cross-platform compatibility. To update, simply run:

npm install @freemius/sdk@latest

Please find the key changes below.

Alternate Webhook Authentication Method

In some serverless or managed environments, the raw request body may get automatically altered (e.g., by trimming whitespace), which could cause signature verification failures.

To resolve this, we’ve introduced an alternative webhook authentication method that retrieves the event directly from the Freemius API using the event ID included in the webhook payload.

You can read more about the change in our documentation.

Breaking Change: The freemius.webhook.createListener method now accepts a configuration object.

Checkout Upgrade Flow

You can now initiate checkout flows for upgrading existing licenses simply by passing a license ID. This simplifies handling upgrades for existing customers and makes the flow more consistent with the rest of the SDK.

Read our documentation to learn more about the upgrade flow.

Breaking Changes:

• checkout.setSandbox() now expects sandbox parameters (created via await freemius.checkout.getSandboxParams()).
• setLicenseRenewal has been renamed to setLicenseUpgradeByKey for clarity and consistency.

Support for Free Trial in Checkout

We’ve added full support for free trial flows across both overlay and hosted checkout modes. This allows for smoother onboarding experiences for products offering free trials—without the need for separate integration logic.

You can read our updated guide for more details. The same integration flow now works seamlessly for free trials too.

We will update our entitlement guide supporting trials soon.

Checkout Redirection Bug Fix

We identified an issue where the Checkout API processor was incorrectly validating the action URL parameter, and the timingSafeEqual function could throw errors on malformed signatures. Both issues have now been fixed to ensure smoother and more reliable redirection-based checkouts.

Want to See it in Action?

Check out our live-coding webinar where we’ve built a SaaS app and integrate it with Freemius using the new JavaScript SDK + React Starter Kit – from setup to checkout in under 30 minutes. Watch the webinar replay

We are releasing a new version 1.4.0 of our Checkout JavaScript SDK. This update introduces proper type support for Free Trial flows.

Previously, in the success callback, you couldn’t access structured data when a free trial was triggered. With this release, the data is now available under the data.trial property with full type annotations, making it easier to build consistent post-trial experiences.

Please note that this enhancement applies only to free trials. For paid trials, you should continue using the data.purchase property.

If you’re using the CDN version, no action is required — the update is already live. For NPM installations, please upgrade by running:

npm install @freemius/checkout@latest

For more details, please visit our GitHub repository.

Our cart mechanism now fully supports the license upgrade flow. A license upgrade flow occurs when your buyers attempt to upgrade their plan—whether through the Customer Portal, the WordPress SDK, or a custom integration.

Previously, our cart system had limited support for this flow. With this update, it now functions seamlessly for all upgrade scenarios.

Now, when your buyers initiate a plan upgrade but abandon the process midway, Freemius’ cart recovery process will automatically trigger to help recover the transaction—boosting your conversion rate and revenue.

We noticed a regression where, when the Checkout was used under Free Trial mode, the redirected page did not receive all of the expected payloads — for example, the license ID created for the trial, its expiration date, and other related information.

We have now deployed a fix for this issue. If you’re using the Checkout Redirection feature, you can now correctly access license information even for free trial flows. Please refer to our documentation to learn how to set up checkout redirection after a successful purchase.

We’re thrilled to unveil a major update to one of the most customer-facing parts of our platform — the Customer Portal. It’s now fully redesigned and rebranded with a cleaner interface and smarter UX throughout.

The Customer Portal is a self-service dashboard your customers use to manage their purchases, subscriptions, licenses, and billing information. From changing payment methods or upgrading plans to downloading software and generating VAT-compliant invoices — everything happens here seamlessly. And with this release, it all just got a lot better.

We’re rolling out the redesigned portal for everyone under a new subdomain: https://customers.freemius.com.
If your integration or website still links to the old https://users.freemius.com domain, you’ll be automatically redirected to the new one.

However, if your store uses custom CSS to style the Customer Portal, your integration will stay on the legacy version until you manually migrate. You can find the migration guide at the end of this changelog.

Now, let’s go through some of the key updates:

Websites Page Improvement

On the main Websites page, we group and display all the websites where buyers have activated any Freemius-powered product. Each website may have one or more products associated with it.

Previously, it wasn’t very clear that you could click and navigate individual items inside the list. We’ve added a folder icon and removed the right-side chevron to make the navigation more intuitive.

Better UI Positioning

Across the app, we conducted UX audits and made numerous layout adjustments to position key UI elements where users expect them.

For example, in the Downloads page, the download button was previously placed at the end, often requiring a horizontal scroll on smaller screens to access it.

Now, the button appears just after the product title, bringing important actions closer to your fingertips.

This is just one of many small but impactful improvements throughout the portal.

Better Table Layout

We revamped the table design across the Customer Portal for better usability and consistency.

1. Tables now better adapt to the available screen space.
2. Tables that open a window or side panel are now clearly marked with a chevron.
3. Labels and action buttons have been standardized to make their purpose clear. For instance, expired licenses are now highlighted in red for quick visibility.

FAQ Page Redesigned

The FAQ page has been restructured into two columns and organized by categories, making it easier to browse and find what you’re looking for.

With this new layout, finding answers to your questions is now faster and more intuitive.

Other Notable Improvements

1. Menu items have been renamed for clarity and industry alignment—for example, “Subscriptions” replaces “Renewals & Billings,” and “Invoices” replaces “Order History.”
2. Breadcrumbs and other navigation elements have been refreshed, fixing several old bugs.
3. If you use custom CSS for the Customer Portal, the initial flash of unbranded UI will no longer appear.
4. All new brand-related changes continue to meet accessibility standards.

How to Upgrade to the New Design

We’ve released the newly rebranded Customer Portal under the subdomain https://customers.freemius.com. For most makers still using the old domain https://users.freemius.com, we’ve set up automatic redirects to ensure a seamless transition.

However, if you’re using custom CSS to brand your portal, we’ve preserved your old design since the latest CSS and markup changes are breaking in nature.

To help you migrate smoothly, your existing CSS has been moved under a new setting called “Legacy Customer Portal CSS Stylesheet”, leaving the original configuration empty. You can view this update in your Developer Dashboard under Store Settings.

To migrate to the new Customer Portal, follow these steps:

1. Update your CSS according to the new customization guidelines.
2. Save your configuration in the Developer Dashboard.
3. Follow our migration guide to complete the upgrade.

We noticed a minor regression in some of our system emails sent to makers, where the label or type of quota associated with a license was missing.

For instance, in the after-purchase email, while the plan title appeared correctly under the License section, the corresponding quota label was omitted—causing a bit of confusion for recipients.

This issue has now been fixed. The purchased quota is once again properly displayed beside the plan name in all relevant system emails.

We noticed a minor issue in the WP SDK Integration code generated by our Developer Dashboard. These integration snippets are simple copy-paste blocks that you can use to integrate your WordPress Plugin or Theme with the Freemius WP SDK in minutes.

The issue involved a small typo and a formatting glitch.

We’ve now fixed the typo and adjusted the formatting to ensure the snippet is error-free and follows WordPress’ standard code styling.

This week we’re rolling out improvements to the affiliates section in the Developer Dashboard.

Our system automatically calculates affiliate payouts and balances every month. Once you mark a payout as “paid,” you no longer need to manually adjust the status of individual referrals.

Previously, there used to be an option under the “Referrals” section to manually mark each referral as “Paid.” This was a remnant of the older manual payout system and is no longer needed. However, since the UI element remained, it occasionally caused confusion among makers.

To make things clearer and prevent mistakes, we’ve simplified the “Status” column in the Referrals table to only show whether a referral is pending or paid. This status is now handled entirely by the system and can no longer be updated manually.

You can still click the three-dot menu to “Reject” referrals for suspicious activities, just like before. However, this action will only work if the referral hasn’t yet been included in the upcoming payout cycle.

We noticed that the relative date shown in some parts of our Developer Dashboard had an inconsistency, especially when the value fell within a specific range.

We’ve rolled out a fix to address this issue. Relative date and time displays are now consistent across the entire Dashboard.