Shopify

Add the Patchrooms loader to your theme’s theme.liquid so it renders on every storefront page built from that theme.

Prerequisites

• Access to Online Store → Themes → Edit code for the theme you want to add it to.
• A project key (pr_…) from your Patchrooms dashboard, under Settings.

Public vs secret keys

A pr_… project key is public and safe to paste into theme.liquid. A secret pr_sk_… key (used for MCP access) must never go into a theme file.

Add the snippet

1. Go to Online Store → Themes, find the theme, and click Edit code.

2. Open the theme’s layout/theme.liquid.

3. Paste this just before the closing </body> tag:

   <script src="https://room.patchrooms.com/v1/patchrooms/pr_xxx.js"></script>

   Replace pr_xxx with your project key.

4. Save.

• Directoryyour-theme/

  • Directorylayout/

    • theme.liquid

Note

On most Shopify plans, checkout pages render from Shopify’s own checkout, not theme.liquid — so this snippet won’t reach checkout. That’s expected; the widget covers your storefront pages (product, collection, cart, custom pages), not the checkout flow.

Use a preview theme for redesign review

If you’re reviewing a redesign in progress, don’t edit the theme customers currently see. Duplicate it first (Themes → Actions → Duplicate), add the snippet to the duplicate’s theme.liquid, and use Shopify’s Preview button on that theme to open it without publishing. Reviewers get the Patchrooms widget on the redesign; storefront visitors on the live theme see nothing.

Verify it works

1. Open the theme preview (or the live storefront, if that’s what you wired up).

2. Confirm the Patchrooms launcher appears docked to the edge of the viewport.

3. Click it, leave a text block, and submit. The report should appear in your project’s Feedback tab within a few seconds.

If the launcher doesn’t show up, see Troubleshooting — double check you edited the theme you’re actually previewing (a duplicate has its own theme.liquid, separate from the original), and that the pr_xxx placeholder was swapped for your real key.