`benecaster_subscriber_never_accessed_grace_days`

Filter Premium

Filters how many days must elapse after a token is issued before one that has never been polled qualifies for the never_accessed transition on a given show. Default: 7. Applied per row, so the window can differ per show.

Widen it where subscribers are slow to onboard by nature — annual plans, corporate rollouts, an audience that signs up in a burst around a launch. Tighten it where onboarding is fast and a week of silence already means something went wrong.

Governs benecaster_subscriber_never_accessed and the Never set up segment on the subscribers list.

Parameters

Name	Type	Default	Description
`$days`	`int`	—	The current grace window in days. `7` unless already filtered. Minimum 7 — lower values have no effect.
`$show_id`	`int`	—	ID of the show the token belongs to, so the window can vary per show.

Returns: int

Examples

Give annual subscribers on one show three weeks to get set up

add_filter( 'benecaster_subscriber_never_accessed_grace_days', function ( int $days, int $show_id ): int {
    // Show 12 sells annual plans; subscribers often set up weeks later.
    return 12 === $show_id ? 21 : $days;
}, 10, 2 );

Notes

The engagement check runs on WP-Cron, which fires on site traffic, so on a quiet site the transition can lag whatever window you set.