Skip to main content

Subscription Lifecycle Actions

Actions for Subscription Lifecycle. Every other area is listed on the Action Hooks Reference. Each name links to its own page, with its parameters, notes and an example.

Fire when a subscriber’s membership changes state on the connected bridge — activated, cancelled, moved to a different tier, renewed, or failed to pay.

Hook Description
benecaster_subscription_activated Fires when a subscriber becomes active on any bridge
benecaster_subscription_synced Fires when Sync Existing Members, mapping a level, or a MemberPress or WooCommerce Subscriptions renewal links somebody who already belonged to the membership plugin, instead of benecaster_subscription_activated; receives $user_id, $show_id, $tier_slug, $started_at
benecaster_subscription_cancelled Fires when any bridge reports a subscription has been cancelled
benecaster_subscription_tier_changed Fires when a built-in-membership subscriber moves from one tier to another, or an admin changes their tier; sends the Tier Change email. Not fired for a membership plugin’s plan change
benecaster_subscription_tier_moved Fires once whenever a subscriber holds a different tier, whatever reported it — membership plugin, built-in membership or admin; sends nothing. Rank the move with benecaster_compare_tiers()
benecaster_subscription_free_switch_scheduled Fires when a built-in-membership subscriber chooses the show’s free plan; the move lands at their renewal
benecaster_subscription_free_switch_landed Fires when that move lands: the subscriber is on the free tier with the same feed URL
benecaster_subscription_free_switch_cancelled Fires when that move is withdrawn before it lands, by the subscriber or by cancelling their membership
benecaster_subscription_renewed Fires when a built-in-membership subscription renews or its billing state changes without a tier change. Not fired for a membership plugin’s renewal
benecaster_subscription_payment_failed Fires on the first failed payment of a billing retry cycle, while the subscriber keeps their feed. When the retries run out, benecaster_subscription_cancelled fires instead (on built-in membership, the subscription moves to unpaid)

See Also

Need this built rather than just documented? See our services →