> For the complete documentation index, see [llms.txt](https://www.locksmith.guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.locksmith.guide/tutorials/more/use-a-klaviyo-list-or-segment-as-an-access-control-list.md).

# Use a Klaviyo list or segment as an access control list

Locksmith allows you to use an already-existing Klaviyo list or segment to determine who gets access to your locked content.

The "Klaviyo member" key condition in Locksmith can check your Klaviyo lists or segments directly, to see if the current visitor should have access, and will grant or deny access accordingly.

To set this up, choose the key condition labelled "if the customer is a member of a Klaviyo list or segment":

<figure><img src="https://277214568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUeGWHuijBPr8Og1Gta%2Fuploads%2FgOzwmkvq22u9YfbiO52l%2FScreenshot%202026-10-14%20at%2012.43.02%E2%80%AFPM.png?alt=media&amp;token=f1620f8c-6cc6-4882-be4c-1b641a5e1b01" alt=""><figcaption><p>Optional: Use the filter box and type "klaviyo" for quick access.</p></figcaption></figure>

{% hint style="warning" %}
**Editorial note:** Retake this screenshot. It shows the July 2025 key condition picker.
{% endhint %}

{% hint style="info" %}
Please note that this particular key condition does NOT subscribe new members, but you'll notice in the screenshot above that Locksmith *also* has a key condition for subscribing new members. [More information on that here](https://www.locksmith.guide/tutorials/more/klaviyo.md).
{% endhint %}

## API Key access

The first time you access one of our Klaviyo key conditions, you'll need to set up Locksmith's API access to your Klaviyo account. This is covered in detail in our guide here:

[Grow your subscriber lists with Klaviyo](https://www.locksmith.guide/tutorials/more/klaviyo.md#klaviyo-api-access)

Your API key must grant "Full access" to the same four scopes in every case. "Segments" is especially important when using this key condition:

* List
* Profiles
* Segments
* Subscriptions

<figure><img src="https://277214568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUeGWHuijBPr8Og1Gta%2Fuploads%2FgXfxGfeV2ydobrZHSiRP%2FScreenshot%202026-10-14%20at%2011.59.40%E2%80%AFAM.png?alt=media&amp;token=2c871f10-ab9a-42ce-8528-e3cfbe3ff67d" alt=""><figcaption></figcaption></figure>

## Setup

Take note of these settings:

<div align="left"><figure><img src="https://277214568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUeGWHuijBPr8Og1Gta%2Fuploads%2FZQDqsRN3AY8dMFpTxFEO%2FScreenshot%202026-10-14%20at%2012.53.19%E2%80%AFPM.png?alt=media&amp;token=bb116186-5c1c-40e3-bc6a-da924a515d27" alt=""><figcaption></figcaption></figure></div>

### List or segment

Use the **Resource type** dropdown to choose a list or segment. Select **List** to show **Select a list...**, then choose from the radio buttons for lists in your Klaviyo account.

Use **Create a new list** to open Klaviyo in a new tab and create a list:

<figure><img src="https://277214568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUeGWHuijBPr8Og1Gta%2Fuploads%2FY7ibyeuBFgmG3qxXMwl4%2FScreenshot%202026-10-14%20at%2012.54.57%E2%80%AFPM.png?alt=media&amp;token=707d1fcc-1545-4d56-9fb3-db7013c7c3ec" alt=""><figcaption></figcaption></figure>

Lists and segments function the same in practice. Locksmith asks Klaviyo whether the supplied email address is on the selected list or segment.

The key condition also states that it only checks existing list members. It does not add new subscribers.

### "Only check signed-in customers" setting

This setting changes the behavior of this key condition significantly!

<figure><img src="https://277214568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUeGWHuijBPr8Og1Gta%2Fuploads%2FqORvgaOy9KfhGbSHyDIk%2F2026-10-14%2012.56.50.gif?alt=media&amp;token=2fa684c6-bba4-4700-8d49-ad68b3be5956" alt=""><figcaption></figcaption></figure>

If left off (the default), Locksmith will prompt the visitor to enter their email address. The email address is the ONLY thing the customer needs to enter in this case, there is no requirement to sign in. This is what that would look like in your storefront:

<div align="left"><figure><img src="https://277214568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUeGWHuijBPr8Og1Gta%2Fuploads%2Fa8tClDVvAFW6FHT8lQuE%2FScreenshot%202025-07-31%20at%2013.11.20.png?alt=media&amp;token=0f266345-cdf6-44e7-b41e-0a8ffe0615d4" alt=""><figcaption><p>This is the default input prompt message displayed to customers, but - like all of our default message prompt - can be customized as needed.</p></figcaption></figure></div>

If turned ON, customers will be required to sign in. Then, once signed in, Locksmith will either grant or deny access depending on if the customer is found in the configured list or segment. Here is an example of Locksmith's sign in page:

<div align="left" data-full-width="false"><figure><img src="https://277214568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUeGWHuijBPr8Og1Gta%2Fuploads%2FqKg3VRHndqx34mcevZnL%2FScreenshot%202025-07-31%20at%2013.14.42.png?alt=media&amp;token=406d05cd-9611-49b5-bf63-b7e8b4a9b9a7" alt=""><figcaption><p>The login button in this case brings the customer to the customer sign in page for your store. If you are using Shopify's Legacy customer account system, the customer will instead be presented with the entire customer login form right on the page.</p></figcaption></figure></div>

### "Remember for signed-in customers" setting

Select **Remember for signed-in customers** to let Locksmith remember signed-in customers. It lets them in automatically next time.

{% hint style="info" %}
**Tip**: Have multiple Klaviyo lists that you want to check? You can add separate keys to represent each list you'd like to check. To do this, after creating your first key and closing the configuration popup, click the "+ Add another key" button, and you can do it all over again, selecting a different Klaviyo list.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.locksmith.guide/tutorials/more/use-a-klaviyo-list-or-segment-as-an-access-control-list.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
