[benecaster_current_tier]
Outputs the tier name or slug for the currently logged-in subscriber on a given show. Resolves the visitor’s WordPress user ID, looks up their active token for the show, and returns the tier display name or the raw tier slug depending on the format attribute. Returns the fallback value for unauthenticated visitors, visitors with no token for the show, or when no tier is mapped.
show_id resolution order: (1) explicit show_id attribute, (2) show or episode single post context, (3) sole-show fallback via benecaster_get_sole_show_id() on single-show installs, (4) no show resolved — returns the fallback value. Multi-show installs with no explicit show_id and no post context return the fallback.
Output filterable via benecaster_current_tier_output.
Parameters
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
show_id |
int |
current show
|
No | ID of the show to resolve the tier for. Resolved automatically from post context or sole-show install when omitted. |
format |
string |
name
|
No | Output format. name — display name from the bridge (e.g. 'Founding Member'); slug — raw tier slug stored on the token (e.g. 'founding'). |
fallback |
string |
— | No | Text to output when the visitor is unauthenticated, has no token for this show, or has no active tier mapping. Defaults to an empty string (outputs nothing). |
Example
<!-- Greet the subscriber by tier name -->
Welcome back, [benecaster_current_tier show_id="3"] member!
<!-- Conditional block using the raw slug -->
[if tier="[benecaster_current_tier show_id="3" format="slug"]" value="founding"]
You have founding-member access.
[/if]
<!-- Fallback text for non-subscribers -->
[benecaster_current_tier show_id="3" fallback="free listener"]