> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://revoq.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Embedding in Vintage Themes

**Vintage themes – older Shopify themes from before Online Store 2.0 – don't support app blocks. The embedding options "Dedicated withdrawal page" and "Button in a section" therefore don't work. But: You can still fully use Revoq with a vintage theme. This article shows you how.**



# Do I even have a vintage theme?

Vintage themes are all Shopify themes released **before July 2021**. Well-known examples:

* Debut
* Brooklyn
* Minimal
* Supply
* Simple
* Venture
* Boundless
* Narrative

Here's how to find out:

1. In your Shopify admin, go to **Online Store → Themes**.
2. On your active theme, click **Customize**.
3. In the theme editor: If you see **no puzzle icon** in the top bar and there's **no "Add app block"** option in your sections → it's likely a vintage theme.

| Tip: When in doubt, check the Shopify Theme Store – all themes there are labeled as vintage or Online Store 2.0. If your theme is no longer findable in the store, it's very likely vintage.



# The recommended approach: Floating Button

The **fastest, easiest, and best solution for most vintage-theme shops** is the Revoq Floating Button. It works in vintage themes because it's loaded as an **app embed** – and app embeds are supported by vintage themes too.

Here's how to activate it:

> [Guide: Activate the Floating Button](https://revoq.crisp.help/en/article/activate-the-floating-button-rflssz/)

That gives you a fully functional solution in 30 seconds – and you don't need to deal with the more advanced methods below.

| Recommendation: If you're unsure whether you like the floating button visually or whether it fits your shop design – **try it out first**, before tackling the more complex methods. The effort is minimal, and you can deactivate it again at any time.



# If the Floating Button doesn't fit: Use a custom trigger

You don't want to show a floating button, but still want to open the withdrawal popup via your **own link or button** in the footer? That works – and it's the second-best approach for vintage themes.

## How the principle works

You **activate the `Revoq Floating Button` app embed**, but **hide the visible button**. That keeps the popup functionality active without the floating button appearing. You then trigger the popup via your own link or button.



# Step 1 · Activate and hide the Floating Button

1. Go to **Online Store → Themes → Customize**.
2. Click the **puzzle icon** in the top bar (App embeds).

| Note: Even if your vintage theme doesn't support app blocks in sections – app embeds are a separate feature and do work in vintage themes.

3. Find `Revoq Floating Button` and **activate the toggle**.
4. Click the app embed to open its settings.
5. Activate the toggle **"Hide floating button"**.
6. Click **Save** in the top right.

The app embed is now active – the popup works – but the floating button itself is hidden.

![](https://storage.crisp.chat/users/helpdesk/website/-/9/d/0/a/9d0aebb43b89f800/bildschirmfoto-2026-05-22-um-1_tv8hl2.png)



# Step 2 · Set up your own trigger

You now have four ways to open the popup. Choose the one that best fits your theme and your technical comfort level.

| No matter which method you choose – the trigger is always the same anchor: **`#revoq-widerruf`**. Write it exactly like that – even in English-language shops. A "translation" to `#revoq-withdrawal` or similar will not work.



## Method A · Menu link (no code, recommended)

The simplest way to trigger the popup is a **menu link with a special anchor**. You don't need any code for this – just the Shopify navigation.

1. In your Shopify admin, go to **Content → Menus**.
2. Click on your footer menu (e.g. "Footer menu").
3. Click **Add menu item**.
4. Choose a clear label, e.g.:
* "Withdraw contract"
* "Cancel order"
* "Submit withdrawal"
5. In the link field, **manually enter** the following anchor:

```
#revoq-widerruf
```

6. Click **Save**.

Once the menu item is saved and the footer menu is rendered on your pages, clicking the link opens the withdrawal popup.



## Method B · Custom button in your theme (no code)

Many vintage themes offer the option to add a **custom button** in the footer or another section via theme settings – typically with options like "Button text" and "Button link". If your theme supports this, it's a more visually prominent alternative to the menu link.

Here's how:

1. Go to **Online Store → Themes → Customize**.
2. In the theme editor, navigate to the footer area or the section where you want to place the button.
3. Look for a setting like "Footer button", "Custom button", or "Call to action".
4. Enter a clear label as the button text (e.g. "Withdraw contract").
5. Enter as the button link:

```
#revoq-widerruf
```

6. Save.

| Note: Not every vintage theme offers a configurable footer button. If you can't find this option, use Method A (menu link) instead or ask your theme provider whether a button element can be added.



## Method C · URL parameter (for direct links)

If you want to direct customers to a page with the popup already opened – e.g. from an email campaign – you can use the URL parameter:

```
https://yourshop.com/?revoq=open
```

When this URL is opened, the popup opens automatically.

**When this is useful:** For campaigns, email links, or external links that should lead directly to the withdrawal form. For standard footer embedding, use Method A or B instead.



## Method D · JavaScript trigger (for advanced users)

For developers or advanced theme customizations, there's a JavaScript call:

```javascript
window.RevoqWithdrawal.open()
```

You can bind this call to a custom button in your theme code, for example:

```html
<button onclick="window.RevoqWithdrawal.open()">Withdraw contract</button>
```

||| This method is only intended for users with theme code experience. If you're not sure what Liquid or the HTML editor in Shopify means, use Method A (menu link) or Method B (custom button) instead.



# Step 3 · Functional check

After setup, **always test the complete flow once**:

1. Open your shop in an **incognito window**.
2. Scroll to the footer and click the new withdrawal link or button.
3. The withdrawal popup should open.
4. Submit a test withdrawal using your own email address.
5. Verify that you receive the confirmation email.

Everything working? Then your embedding is live.

> More on the complete functional check in the [Go-Live Checklist](https://revoq.crisp.help/en/article/go-live-checklist-are-you-ready-for-june-19-2026-1ppy570/).



# Common Issues

### Nothing happens on click

* Did you actually **activate** the `Revoq Floating Button` app embed (even if "Hide floating button" is also activated)? The embed must be active for the popup to load.
* Did you write the anchor as `#revoq-widerruf` exactly (no typo, no extra space)?
* Clear your browser cache or check in incognito mode.

### The link just scrolls on the page instead of opening the popup

Some themes interpret anchor links (#) by default as jump targets within the page. In that case, the browser tries to scroll to an element with the ID `revoq-widerruf` – which doesn't exist.

Solution: Verify that the `Revoq Floating Button` app embed is actually active. If yes, the trigger should work. If not, [reach out to us](mailto:hello@buschbytes.com) and we'll take a look together.

### My theme doesn't have a custom button option

Not every vintage theme offers a configurable footer button. In that case, use **Method A (menu link)** – it works in any theme with a footer menu.

### I can't find the app embeds area or the puzzle icon

In very rare cases, your theme is so old or heavily modified that it doesn't support app embeds. In that case, none of the Revoq embedding options are natively available.

Recommendations in this case:

* **Update your theme** – if your theme is still actively maintained, there's likely a newer version with app embeds support.
* **Switch themes** – Shopify's free Online Store 2.0 themes (e.g. "Dawn") are more modern and fully compatible.
* **Contact your theme provider** – if your theme is from a third-party vendor.

If needed, [reach out to us](mailto:hello@buschbytes.com) – we can help assess what makes most sense in your specific case.

### My menu link is displayed with the shop URL in front of it (`yourshop.com/#revoq-widerruf`)

That's normal. Shopify automatically adds the shop URL before the anchor. The link still works.



# Next steps

* Go through the [Go-Live Checklist](https://revoq.crisp.help/en/article/go-live-checklist-are-you-ready-for-june-19-2026-1ppy570/) to verify compliance requirements
* [Highlight the footer link to your withdrawal page](https://revoq.crisp.help/en/article/highlight-the-footer-link-to-your-withdrawal-page-ya505x/) (custom CSS)