New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebeedocs
HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee


  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model Context Protocol)

Developer Resources


  • Developer Resources Overview
  • Articles and FAQ

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Entitlements


  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
    • Item Entitlements Grandfathering
    • Entitlement Versions
  • Articles and FAQ

Usage Based Billing


  • Understanding Usages
  • Setting up Usage Based Billing
  • Usage Alerts
  • Metered Billing
  • Articles and FAQ

Chargebee CPQ


  • Chargebee CPQ
  • Chargebee CPQ for Salesforce
  • Chargebee CPQ for HubSpot

Invoices, Credit Notes, and Quotes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Managing Payments with Chargebee.js
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Approvals
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Multi Business Entity


  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions


  • Overview
  • Omnichannel Subscriptions
  • Omnichannel One-Time Orders
  • Mobile Subscriptions (Legacy)

Reports and Analytics


  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Entitlements
  3. Grandfathering Entitlements
  1. Billing
  2. Entitlements
  3. Grandfathering Entitlements

Overview

As your product evolves, so will its features and pricing. While it’s crucial to innovate and introduce changes for growth, it’s equally important to preserve trust and continuity for your existing customers.

Grandfathering item entitlements in Chargebee allows you to control how entitlement updates to your plans, features, and pricing are applied-whether exclusively for new customers or across your entire customer base. This flexibility ensures that you can drive business goals such as customer retention, adoption, acquisition, and operational efficiency without compromising on customer experience.

Example

As Acme Inc. expanded its online storage solutions, it needed to make key updates to its Basic Storage Plan without disrupting its existing customers' experience.

Adding New Features (Only for New Customers): Acme decided to introduce a "Priority Support" feature to enhance their Basic Storage Plan. However, they wanted this benefit to be available only to new customers signing up from June 2025 onward. Using Chargebee's Grandfathering Entitlements, Acme rolled out Priority Support without altering the experience of their existing Basic Plan subscribers, who continued enjoying the plan as they originally signed up for.

Removing Features (Only for New Customers): Later, Acme evaluated that integrating with a third-party service, such as Xero, was no longer strategic for entry-level users. They chose to stop offering the Xero integration for new customers purchasing the Go Plan, but thanks to grandfathering, existing Go Plan customers still retained access to Xero, preserving their original plan benefits.

Benefits of Using Grandfathering Entitlements

When you modify a plan by adding new features, changing pricing, or removing capabilities, you often face two distinct audiences:

  • Existing Subscribers: Customers who expect consistency with what they originally signed up for.
  • New Subscribers: Prospects who will experience the updated offerings.

Managing these two groups thoughtfully is key to:

  • Maintaining Customer Trust: Preserve the experience promised to existing subscribers.
  • Driving Product Adoption: Introduce new features to fresh sign-ups or upsell upgrades.
  • Reducing Churn: Avoid surprising loyal customers with unexpected downgrades.
  • Scaling Smoothly: Adjust pricing models, sunset old features, and optimize infrastructure without disruption.

Here’s how Chargebee’s grandfathering entitlements support your needs:

ScenarioBusiness GoalHow Grandfathering Helps
Add a new feature to a plan, but only for new customersIncentivize new customer acquisitionAllow only new subscriptions to access the new feature while keeping existing subscriptions unchanged
Add a new feature and make it available to both existing and new customersImprove retention, drive adoptionApply feature updates across all subscriptions, increasing customer value
Remove a feature from a plan, but only for new customersMinimize churn, preserve loyaltyExisting subscriptions retain the feature; new subscriptions reflect the updated plan
Remove a feature for both existing and new customersOptimize infrastructure, sunset unused featuresApply removal changes to all subscriptions with communication plans to manage the experience

Note

Enabling Grandfathering imposes the following restrictions:

  1. Entitlement Transfer Configuration: Entitlement transfer configuration will not be supported for sites with Grandfathering enabled.
  2. Deprecated API Functionality: The following deprecated POST APIs will not function when Grandfathering is enabled:
    • Upsert or Remove Item Entitlements for a Feature
    • Upsert or Remove Item Entitlements for an Item

Articles & FAQs

What is entitlement in Chargebee? How to configure it in Chargebee?

Was this article helpful?