Articles on: Getting Started

Activate the Floating Button

The Floating Button is the fastest and most universal embedding option: A floating button appears on every page of your shop and opens the withdrawal form as a popup on click. Works with any theme – including vintage themes. This article shows you how to activate it.


Just getting started with Revoq? Use the guided "Set up Revoq" assistant in the app settings. It activates the Floating Button with a single click.


This article covers the manual approach – relevant if:


  • the setup assistant for the Floating Button has already been completed
  • you've switched themes and need to re-activate Revoq
  • you're setting up a second storefront
  • you want to customize or deactivate the button



How it works


The Floating Button is an app embed – not an app block. That means: It isn't inserted into a specific section, but activated theme-wide and then appears automatically on every page of your shop.


On click, the withdrawal form opens as a popup over the current page.


Why is this the most universal option?


  • Works with any theme (including vintage themes)
  • No theme layout changes needed
  • Visible on all pages immediately
  • Set up in a matter of seconds



Step 1 · Open the theme editor


  1. In your Shopify admin, go to Online Store → Themes.
  2. On your currently active theme, click Customize.



Step 2 · Open App Embeds


App embeds are a separate area in the theme editor – distinct from sections and blocks.


  1. In the top bar of the theme editor, click the puzzle icon (App embeds).
  2. The left sidebar shows all app embeds available in your shop.




Step 3 · Activate the Revoq Floating Button


  1. Find Revoq Floating Button in the list (with the subtitle "Revoq – EU Withdrawal Button").
  2. Switch the toggle to the right of the name to active.
  3. Click Save in the top right.


The Floating Button appears immediately in the preview – by default in the bottom-right corner of the page.




Important: Don't confuse the Revoq Floating Button with the other Revoq app blocks (Revoq Withdrawal Form, Revoq Withdrawal Button). Those don't appear in App embeds – they're inserted as sections or blocks in your template.



Step 4 · Functional check


After activation, always test the complete flow once:


  1. Open your shop in an incognito window.
  2. The Floating Button should be visible in the bottom-right corner (or wherever you positioned it) on every page.
  3. Click it – the form should open as a popup.
  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.



Customizing the Floating Button


In the app embed settings you'll find various configuration options for the Floating Button: position, colors, label, and more.


Details in a dedicated article: Customizing the Floating Button (Customization & Design)



Hiding the Floating Button and triggering it via custom link


In some cases you don't want to show the floating button itself, but still want to use the popup – e.g. to trigger it from your own footer link or menu item. This is especially the typical approach for vintage themes.


In the settings of the Revoq Floating Button app embed, you'll find the toggle "Hide floating button". With it activated, the app embed stays active (so the popup keeps working), but the floating button itself is hidden. You can then trigger the popup in three ways:


  • a menu link with URL #revoq-widerruf
  • the URL parameter ?revoq=open
  • a JavaScript call window.RevoqWithdrawal.open() in your theme code


Detailed guide with all three methods: Embedding in Vintage Themes



Common Issues


The Floating Button doesn't appear


  • Did you click Save in the top right of the theme editor?
  • Is the toggle for Revoq Floating Button actually activated? (Toggle must be colored, not gray)
  • Clear your browser cache or check in incognito mode
  • Verify that "Hide floating button" isn't accidentally activated


The popup doesn't open on click


  • Clear your browser cache or test in incognito mode
  • Check whether other apps might cause conflicts (especially other popup or modal apps)
  • If you see JavaScript errors in the browser console: reach out to us briefly and we'll take a look together



This happens occasionally with multiple floating elements. Solutions:

  • Move the Floating Button to the other side (left instead of right, or vice versa)
  • Increase the margin from the edge via custom CSS
  • Decouple other apps by timing or z-index


Details on customization: Customizing the Floating Button


I can't find an "App embeds" section in the theme editor


Very rare – but if your theme genuinely doesn't support app embeds, it's an extremely old or heavily modified theme. We recommend contacting your theme provider directly or reaching out to us.



Next steps


Updated on: 22/05/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!