> 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/testing-locksmith-on-unpublished-themes.md).

# Testing Locksmith on unpublished themes

By default, Locksmith will only automatically install itself to and update itself on the currently published theme, and does *not* automatically install itself to unpublished themes. However, there is a way to test Locksmith on unpublished themes.

### **To test Locksmith on an unpublished theme:**

1. Head to the in-app "Themes" page.
2. Click the "**Install**" button for the theme you'd like to test Locksmith on:

<figure><img src="/files/UrkbqHG02oBPojR9Ws4l" alt=""><figcaption></figcaption></figure>

4. To preview the lock configuration you just installed, click the **three-dot menu** (…) next to the theme name, and select **Preview**:

<figure><img src="/files/RtUJmBJSJwYvoD71y30Q" alt=""><figcaption></figcaption></figure>

When testing your locks on unpublished or the currently published theme, we recommend using a brand new private browsing session each time:\
[How to use a private browsing session](/tutorials/more/how-to-use-a-private-browsing-session.md)

{% hint style="warning" %}
**Important:** If you're using a URL with the `shopifypreview.com` domain to test, Locksmith changes won't be reflected there. The Shopify theme editor's built-in preview bypasses Locksmith entirely, so locks, keys, and any manual locking code will appear as if they aren't in place.\
\
For accurate testing, always use the preview URL that includes `?fts=0&preview_theme_id=` followed by your theme ID in the URL parameters — as described in this guide.
{% endhint %}

{% hint style="info" %}
Please note: when making changes to your locks and Locksmith settings, Locksmith will only update those on the currently published theme.\
\
To update the unpublished theme after making changes in-app, just click the "Install" button for that theme next to the theme name again, as outlined above.
{% endhint %}

### To remove Locksmith from an unpublished theme:

1. Head to the in-app "Themes" page.
2. Click the "**Uninstall**" button for the theme you'd like to remove Locksmith from:

<figure><img src="/files/uzNmZJsELvHLmIrOzD5J" alt=""><figcaption></figcaption></figure>

### Setting a secondary theme:

Locksmith supports setting a **Secondary theme**, which receives automatic updates along with your published theme when changes are made in Locksmith.

1. In the **Unpublished themes** section, locate the theme you want to set as a secondary theme.
2. Click the **three-dot menu** (…) next to the theme name.
3. Select **Set as secondary theme**:

<figure><img src="/files/pF2ARHvuMtlZTuE8inZi" alt=""><figcaption></figcaption></figure>

This theme will now receive all future updates made in Locksmith, in addition to the published theme.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://www.locksmith.guide/tutorials/more/testing-locksmith-on-unpublished-themes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
