Features Comparison Compare Freemius to EDD, WooCommerce, and CodeCanyon/ThemeForest.
Software Licensing Control what features to enable based on the plan and number of site activations.
Subscriptions Build a sustainable recurring revenue stream.
Automatic Updates Manage and deploy versions all in one place.
Buy Button Easily embed a buy button on your website.
Analytics & Usage Tracking Get actionable insights on user behavior.
Customer Portal A fully-featured members area for customers.
Affiliate Platform Manage affiliates. Track clicks, visits & referrals.
Cart Abandonment Recovery Recover lost sales with automated emails.
EU VAT & UK VAT Offload VAT handling to Freemius.
US Sales Tax Pass sales tax liability to Freemius.
Selling WordPress Plugins The definitive guide on selling plugins successfully, from ideation to launch (and beyond).
Documentation Start by integrating your WordPress plugin or theme in 5 mins to get all our platform features.
Getting Started Getting Started 🚀Integration & ConfigTesting & DebuggingLicensing APIBuy Button JS APIRESTful API
Popular Topics Getting PaidSelling Add-OnsBundles & MembershipsOffering Free TrialsUser's DashboardVersion Deployment
WordPress SDK
PHP SDK
System Status
Changelog
PricingCustomers BlogVideosPodcast MarketingCustomer SupportInterviewsProduct FAQ

Changelog / JS SDK v0.1.0 — Free Trial Support, License Upgrades, and Better Webhook Handling

JS SDK v0.1.0 — Free Trial Support, License Upgrades, and Better Webhook Handling

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.

Alternate authentication of the Webhook JS SDK

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.

Plan upgrade code from JS 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