Articles on: Getting Started

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


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.


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


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





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.





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"
  1. In the link field, manually enter the following anchor:


#revoq-widerruf


  1. 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


  1. 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.





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:


window.RevoqWithdrawal.open()


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


<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.




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.



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 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 – we can help assess what makes most sense in your specific case.



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




Next steps


Updated on: 22/05/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!