Features and entitlements

Features in Mantle help you define exactly what each plan includes and how to handle customers who need more. Whether you’re offering simple yes/no access to capabilities or complex usage limits with overage charges, features give you the flexibility to build the perfect pricing structure.

Understanding features

Think of features as the building blocks of your plans. Each feature represents something your customers can access or use in your app. When you create a feature in Mantle, it becomes available to use across all your plans, but you control exactly how it works for each pricing tier.

Working with usage metrics

Features become even more powerful when combined with usage metrics. Here’s how they work together:

1. Create a usage metric to track the activity (like order count)
2. Connect the metric to your feature
3. Set limits in your plans
4. Configure any overage charges

Now Mantle can automatically track usage against limits and handle any billing adjustments. Learn more about setting up usage tracking in our Usage events & metrics guide.

To create any type of feature, head to the features section and click “Add feature”. From there, you’ll choose which type of feature you want to create:

Boolean features

The simplest type - just yes or no access to a capability. Perfect for:

• Premium capabilities
• Advanced settings
• Optional integrations
• Beta features

Limited features

Want to set specific numerical limits for usage? Limited features let you control exactly how much of a resource or capability each plan can use. Ideal for:

• Monthly order limits
• Storage quotas
• API call volumes
• User seats

Limited features with overage

Need to let customers exceed their limits for an additional charge? Limited features with overage combine usage limits with flexible billing options. Perfect for:

• Processing orders beyond plan limits
• Extra API calls
• Additional storage space
• Seasonal volume spikes

This type requires two steps:

1. Create the feature with overage enabled and set your default limit

2. Configure usage billing in your plan settings

Once configured, Mantle will automatically track usage against limits and apply any overage charges when customers exceed their plan limits.

Configuring features per plan

Once you’ve created your features, you’ll want to customize how they work for each pricing tier. Head to your plans section to:

• Enable or disable features for specific plans
• Set different limits for each plan
• Configure unique overage rates
• Override default settings

For example, you might configure your “orders processed” feature like this:

• Basic plan: 100 orders included
• Pro plan: 500 orders included
• Enterprise plan: Unlimited orders

Remember that when you create a new feature, it’s automatically available to use in all your plans, but you control exactly how it works in each tier.

Pro tips

A few things to keep in mind when setting up features:

• Start with your pricing strategy and think about future growth
• Use clear, consistent naming that makes sense to both your team and customers
• Keep an eye on usage patterns to spot upgrade opportunities and potential issues

Remember: Well-designed features and entitlements make your pricing both flexible and scalable. Take time to plan your feature structure and you’ll build a foundation that grows with your business.

FAQ