Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.beyondwords.io/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Use access tiers to align the player experience with your paywall or membership model, so visitors only hear or see the content they’re entitled to. For example, you can offer ad-free videos to subscribers and limit how much audio anonymous users can play. By default, there are three possible access tiers:
  • anonymous: For non-logged-in visitors
  • registered: For logged-in users
  • subscribed: For paying, logged-in users
You can control content access, whether ads are enabled, and the intro/outro experience for each of these tiers. If your plan supports it, you can create additional access tiers to support more configurations.

Coming soon: Paywall integrations

You will soon be able to integrate BeyondWords directly with paywall providers like Piano, Poool, and others to automatically determine audio and video access for different audiences.

Set up access tiers

1

Go to access tiers settings

Go to Settings → Distribution → Player → Access tiers in your project dashboard.Then, click ••• alongside the access tier you want to edit.
Want to create a new access tier? Contact support.
2

Set access tier criteria

Edit the following fields as required: 
  • Name: The name for this access tier, used for reference only. Please note that this will not change the slug.
  • Content access: Control how much content is available for this audience:
    • Title only: Access is limited to the title.
    • Preview: Access includes the title and first segment.
    • Full content: Access includes all content.
  • Play ads: Play ads before, during, or after content playback.
  • Intro audio: Add audio that plays before content begins.
  • Outro audio: Add audio that plays after content ends.
3

Copy the slug and save changes

Copy the Slug field then click Save changes.
4

Update the player embed code

In your player embed code, add an accessTier parameter and set its value based on the current user’s status on your site:
<script async defer
  src="https://proxy.beyondwords.io/npm/@beyondwords/player@latest/dist/umd.js"
  onload="new BeyondWords.Player({
    target: this,
    projectId: YOUR_PROJECT_ID,
    contentId: 'YOUR_CONTENT_ID',
    accessTier: 'subscribed'
  })">
</script>
Your developer will need to ensure that 'subscribed' is dynamically replaced with whichever tier applies to the current user.Once your embed code is updated, the player will automatically apply the correct tier settings for each user. You can track engagement by access tier in player analytics.
accessTier controls the player experience but is a client-side parameter — it cannot enforce access control on its own. For robust enforcement, native integrations with paywall providers are coming soon.

Example access tier settings

Here are some examples of how publishers can use access tiers to support different monetization and engagement strategies. In this example, the publisher restricts anonymous visitors’ content access and encourages them to register for full access:
AnonymousRegistered
Content accessPreview onlyFull access
Ads enabledNoNo
IntroRegistration CTA-
OutroAudio stingEngagement CTA
In this example, non-subscribers get ad-supported content while subscribers benefit from an ad-free experience:
AnonymousRegisteredSubscribed
Content accessFull accessFull accessFull access
Ads enabledYesYesNo
IntroBrand stingBrand stingBrand sting
OutroRegistration CTASubscriber CTAEngagement CTA

FAQs

If enabled for audio, the intro will play before the pre-roll ad, and the outro will play after the post-roll ad.  
Access tier intros and outros take precedence over project-level intros and outros.If no intro or outro is set for the active access tier, the project-level intro or outro will be used instead.
If accessTier is omitted from your embed code, the player defaults to the anonymous tier settings, which have full access to content and ads by default. If no intro or outro is set for the anonymous tier, the project-level intro and outro will apply as a fallback.Existing embeds will continue to work exactly as before without any changes.
Yes, you can track engagement by access tier in player analytics. Use the filter at the top to focus on metrics for any specific tier.Alternatively, use our analytics integrations to review metrics in your chosen platform.