2026-06-25
Credit wallet soft limit
- Added:
hasSoftLimitfield onCreditEntitlement(via@stigg/js-client-sdk4.6.0). When a credit entitlement is configured as a soft limit,useEntitlement()returnshasAccess: trueandhasSoftLimit: trueeven after the credit balance reaches zero. Hard limit (the default) continues to returnhasAccess: falsewhen the balance is exhausted.
2026-05-18
The Checkout widget now reliably supports changing existing add-on quantities on narrow or embedded screens. The quantity input is fixed-width so it stays fully visible at any viewport size, Undo is stacked beneath it for a cleaner layout, and the controls stay anchored so validation text never pushes the Undo or delete buttons out of place.
2026-04-06
Upgraded MUI dependency from v5 to v7. This is a major version bump — if your application pins MUI, update it to v7 to avoid peer dependency conflicts.
2026-04-01
Bumped
@stigg/js-client-sdk to 4.0.0. The following subset of js-client-sdk breaking changes affect react-sdk consumers:2026-03-18
- Billing address collected via the Checkout widget is now stored on the Stripe Customer object (previously it was stored only as part of the payment method details).
- Billing address entered in the Checkout widget is now automatically reflected in generated invoices.
2026-03-17
Breaking changes:
- Removed
useCreditBalancehook — useuseCreditEntitlementinstead - Removed
showSymbolprop fromCreditBalanceandCreditUtilizationwidgets (no replacement) onAddCreditscallback now receivesCreditEntitlementinstead ofCreditBalanceData
- Added
useCreditEntitlementhook — synchronous, reads from the SDK’s local cache with no extra API call. ReturnscurrentBalance,totalConsumed,totalGranted, andcurrency.
2026-02-18
- Credit balance widget
- Added: “Add credits” CTA button with
onAddCreditscallback for prompting customers to top up credits - Added: New CSS classes:
stigg-credit-balance-add-credits-buttonstigg-credit-balance-add-credits-icon
- Added: “Add credits” CTA button with
- Credit utilization widget
- Added: “Add credits” CTA button with
onAddCreditscallback for prompting customers to top up credits - Added: New CSS classes:
stigg-credit-utilization-add-credits-buttonstigg-credit-utilization-add-credits-icon
- Added: “Add credits” CTA button with
2026-02-26
- Enhanced
getCreditEntitlementto return currency information.
2025-12-31
- Added support for overriding the default entitlements title via
entitlementsTitle.
2025-12-24
- Added Tax ID collection support to Stripe checkout when enabled, including UI inputs, validation, preview handling, and end-to-end billing state propagation.
2026-01-24
- Added: Auto-recharge Status Widget — displays current auto-recharge settings, recharge rules, and a progress bar tracking monthly spend against the spend limit.
- Added: Auto-recharge Configuration Widget — allows customers to toggle auto-recharge, adjust low-balance thresholds, set target top-up amounts, and configure monthly spending caps.
2025-12-11
- Added class
stigg-checkout-summary-containerfor configuring a custommin-widthfor the checkout summary container.
2025-12-03
- Fixed checkout layout jumping on medium screens and improved spacing for add-ons.
2025-11-23
- Improved package performance and reduced download size.
2025-11-20
- Improved add-on checkout layout and conditional rendering.
- Hidden quantity input when only a single instance is allowed.
- Added auto-focus and select behavior to quantity field edits.
2025-11-16
- Added the ability to pass the
skeletonPlanCountparameter to thePaywallcomponent to customize the number of columns on the skeleton. - Added a way to disable the Stripe script so the widget no longer loads
js.stripe.comwhen Stripe isn’t used.
2025-10-30
- Added pagination to credit grants table widget.
2025-10-26
- Switched watermark control to the new
showWatermarkentitlement.
2025-10-20
- Fixed console warning.
2025-10-20
- Checkout widget
- Changed the view of checkout summary when only annual plan available.
2025-10-12
- Fixed type error.
2025-10-08
- Checkout widget
- Added: Callbacks
onBeforeStepChange,onAddonChange, andonBillableFeatureChangefor validation and step gating.
- Added: Callbacks
2025-09-09
- Updated SDK to prevent dependency on compromised NPM packages
2025-09-08
- Checkout widget
- Added: Support for integration with Zuora
2025-09-01
- Added:
AccessDeniedReason.Revokedfor determining when an entitlement has been explicitly revoked.
2025-07-03
- Pricing table
- Added: visibility for compatible add-ons under each plan

- Added: visibility for compatible add-ons under each plan
2025-07-01
- Fixed: error was thrown when using the Stigg React SDK using server-side rendering (SSR)
2025-02-27
- Pricing table
- Added:
CurrentSubscriptionOverrideFntype to support for overriding the current subscription in the paywall. - Bug fixes
- Added:
2025-02-20
- Bug fixes
2025-02-03
- Checkout widget
- Added: New CSS classes (see here):
stigg-checkout-summary-captionsstigg-checkout-summary-captions-remaining-creditsstigg-checkout-summary-captions-scheduled-updatesstigg-checkout-summary-captions-next-billing
- Added: New CSS classes (see here):
2025-01-16
- Bug fixes
2025-01-14
- Fixed: price amounts with decimal points now always appear with 2 decimal points (i.e.
$23.1will appear as$23.10).
2025-01-12
-
Added: custom React hooks
- useStiggContext
- useBooleanEntitlement
- useNumericEntitlement
- useMeteredEntitlement
- useActiveSubscriptions
- useCustomerPortal
-
Added: entitlement guard components
- BooleanEntitlementGuard
- NumericEntitlementGuard
- MeteredEntitlementGuard
- Added: support for offline mode
2024-12-17
-
Added:
GetUsageHistoryV2 -
⚠️ Deprecated:
GetUsageHistory(please useGetUsageHistoryV2instead) -
Changed:
- Input Object:
customerRefIdrenamed tocustomerIdresourceRefIdrenamed toresourceIdfeatureRefIdrenamed tofeatureIdresetPeriodremovedyearlyResetPeriodConfigurationremovedmonthlyResetPeriodConfigurationremovedweeklyResetPeriodConfigurationremoved
- Output Object
startDateremovedendDateremovedusageMeasurements[i].daterenamed toseries[0].point[i].timestampusageMeasurements[i].valuerenamed toseries[0].point[i].valueusageMeasurements[i].isResetPointrenamed toseries[0].point[i].isResetPoint- Old Value:
trueif and only if usage was reset due to periodic reset. - New Value:
trueif and only if usage was reset due to periodic reset or due to a plan transition.
- Old Value:
groups[i].groupInfo[j].keyrenamed toseries[i].tags[j].keygroups[i].groupInfo[j].valuerenamed toseries[i].tags[j].valuegroups[i].usageMeasurements[j].daterenamed toseries[i].point[j].timestampgroups[i].usageMeasurements[j].valuerenamed toseries[i].point[j].valuegroups[i].usageMeasurements[j].isResetPointrenamed toseries[i].point[j].isResetPoint- Old Value:
trueif and only if usage was reset due to periodic reset. - New Value:
trueif and only if usage was reset due to periodic reset or due to a plan transition.
- Old Value:
- Input Object:
2024-12-08
- Added: ability to override prices when there’s a scheduled update in place (currently without widgets)
2024-11-28
- Customer portal widget
- Fixed: Block size is not displayed in Subscription section
2024-10-29
-
Checkout widget
- Added: responsive layout for mobile
-
Customer portal widget
- Added: responsive layout for mobile
2024-10-28
-
Checkout widget
- Fixed: stair-step pricing values are now formatted using commas (,)

- Fixed: stair-step pricing values are now formatted using commas (,)
-
Pricing table widget
- Fixed: stair-step pricing values are now formatted using commas (,)

- Fixed: stair-step pricing values are now formatted using commas (,)
2024-10-10
- Checkout widget
- Added: Ability to skip steps
- Added: New CSS classes
stigg-checkout-progress-containerstigg-checkout-summary-plan-title-containerstigg-checkout-summary-usage-charges-containerstigg-checkout-summary-base-charges-container
2024-06-20
- Pricing table widget
- Added: support for yearly reset period
2024-06-20
- Fixed: custom CSS not reflected in Checkout Widget
2024-06-20
- Fixed: custom CSS not reflected in Customer Portal Widget
2024-02-08
- Checkout widget
- Added: price breakdown in tiered pricing
2024-02-05
- Customer portal widget
- Added:
stigg-entitlement-usageclass to allow hiding entitlements
- Added:
