Docs
Packages
What it is
Packages describe reusable grant amounts in one usage unit, including how grant buckets expire.
When to use it
Create packages for RevenueCat product and entitlement mappings, or for direct backend package grants.
How to use it
How they work
No expiration
Package grant
Bucket has no expiresAt
Consumed after expiring buckets
RevenueCat period end
Subscription event
RevenueCat period end
Bucket expires at that time
After N days
Trial or promo package
Add configured days
Bucket expires automatically
A package has a name, amount, usage unit, and expiration policy. Meterly generates the package ID. RevenueCat mappings point to packages. When a mapped purchase event arrives, Meterly grants the package to the RevenueCat app user. Use no expiration for one-time packages, RevenueCat period end for subscription packages, and after N days for trial or promo packages.