> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pcnaid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add the theme blocks

> Add the Customer Gate application-form and access-gate blocks to your Online Store 2.0 theme.

# Add the theme blocks

## What does this do for me?

The **Customer Gate** theme extension ships two blocks: the **Customer Gate form** (`application-form`) block that renders the application, and the **Customer Gate message** (`access-gate`) block that shows access messaging beside a denied experience.

## Before you begin

These blocks are section app blocks. They work on Online Store 2.0 themes that use JSON templates, such as Dawn. Vintage themes that use Liquid templates do not support them, so upgrade to an Online Store 2.0 theme to host storefront blocks. Checkout enforcement continues separately at checkout.

## 1. Open the theme editor

Open **Settings**, then the **Theme app extension onboarding** section. The app builds deep links to the theme editor once your shop domain is known. Links open your current published theme at **Online Store > Themes**. To configure or preview on an unpublished draft theme, use **Online Store > Themes** in Shopify admin.

## 2. Add the Customer Gate form block

The `application-form` block renders a published form on a page template:

1. In the theme editor, add the **Customer Gate form** block to a page or index template.
2. Set the **Form slug** to the slug of a published form.
3. Paste the one-time **Form key** from **Settings** so storefront submissions authenticate.
4. Keep the default **Proxy path** (`/apps/customer-gate`) unless the store customized its app proxy path.
5. Optionally set a **Document type** for applicant attachments. The default is `resale_certificate`.

Forms with **Require customers to sign in** enabled do not render in this block; it shows an account notice and link instead.

## 3. Add the Customer Gate message block

The `access-gate` block shows messaging to unapproved customers on storefront, product, or collection templates:

1. In the theme editor, add the **Customer Gate message** block to the templates you gate.
2. Set the **Surface** to `storefront`, `product`, or `collection`.
3. Edit the **Denied message** shown to unapproved customers.
4. Optionally set an **Access URL** and **Access label** (the button text for the application form link).
5. Optionally set a **Support URL** and **Support label** (the button text for the support link).
6. Optionally set a **Protected selector**, a CSS selector to hide from the page when access is denied.

## 4. Test the storefront

Submit a test application, review it under **Submissions**, then confirm the approved customer receives the intended tag and entitlement. Test an eligible and an ineligible checkout before opening the workflow to customers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.