Skip to content

Developers · Users and Permissions

Add an Authorization Policy to a Page

Last updated 11 November 2026

This document discusses associating an Authorization Policy with a page.

Prerequisites

To follow the steps in this tutorial, you must understand the concept of Permissions and have already created a Page and an Authorization Policy.

Steps

Associating an Authorization Policy with a page is a two-step process:

  • Step 1: Edit the page configuration
  • Step 2: Add the 'authorization_policies' key to the page configuration

Step 1: Edit the page configuration

Create a custom page where you only want users with the first name to be able to access:

app/views/pages/john-private-page.liquid

<h2>Hello John!</h2>

Step 2: Add the 'authorization_policies' key to the page configuration

Add the key to page configuration and specify the Authorization Policy for the page:

app/views/pages/john-private-page.liquid

---
authorization_policies:
  - only_allowed_by_johns
---
<h2>Hello John!</h2>

Next Steps

Congratulations! You know how to associate an Authorization Policy with a page. Now you can learn about handling violated Authorization Policies: Handling a Violated Authorization Policy