Google Tag Manager (GTM) Widget Integration

Google Tag Manager (GTM) Widget Integration

This step-by-step guide will help you embed your Revyoos widget into your website using Google Tag Manager. This approach is particularly useful when direct access to the site’s <head> section is restricted.



📌 Step 1: Copy the Universal Code from Revyoos

  1. Log in to your Revyoos dashboard.
  2. Navigate to Widgets > Install Universal Code.



🛠 Step 2: Create a New Custom HTML Tag in GTM

  1. Log in to your Google Tag Manager account.
  2. Select your container and click on Tags in the left-hand menu.
  3. Click New to create a new tag.
  4. Click on Tag Configuration and select Custom HTML.
  5. In the HTML field, paste the Universal Code you copied from Revyoos.



Choose a Trigger for Your Revyoos Widget

Once you’ve added the Revyoos Universal Code inside a Custom HTML tag, it’s time to choose when it should load on your website.

🧩 Set the Trigger

Click on Triggering to select when your widget should be activated.
  1. To load the Revyoos widget on all pages of your website, choose the built-in trigger All Pages.
  2. If you prefer to display the widget only on specific pages, create a custom trigger:
  1. Click the “+” button to add a new trigger.
  2. Name your trigger (e.g., Revyoos Widget - Property Pages).
  3. Choose Page View as the trigger type.
  4. Set conditions based on your needs (e.g., Page Path contains /apartments).

💡 Tip: For floating widgets, the All Pages option usually works best.



💾 Step 3: Save and Publish

  1. Click Save to store your new tag and trigger.
  2. Back in the GTM dashboard, click Submit (top right corner).
  3. Add a version name and description (e.g., “Added Revyoos Widget via GTM”).
  4. Click Publish.

🌍 Step 4: Add the Page URLs in Revyoos

Once the Universal Code is in place on your website through GTM, you can specify where each widget should appear:
  1. In your Revyoos dashboard, go to the Installation tab of the widget you want to install.
  2. In the URL field, enter the specific web page(s) where you want the widget to be visible.
  3. After adding each URL, it will appear in the list below the input field.
  4. The widget will automatically display on all the pages listed there.










Notes
⚠️ Troubleshooting tip:
If the widget does not appear after completing all steps (including adding the URLs in Revyoos), go back to the tag settings in Google Tag Manager and enable the option “Support document.write”.
This ensures compatibility with some widgets that rely on document.write() to render correctly.


🧩 Step 4 (Additional): Find the Positioning Code for Embedded Widgets

⚠️ This step is only required for embedded widgets (List and Slider). Floating widgets do not require this step because they are automatically positioned on the screen.


If you’re using an embedded widget, you need to add a small piece of HTML code to your web page to define where the widget will appear.
  1. Go to the Installation tab of your selected widget in your Revyoos Dashboard.
  2. Find the Positioning Code over the URL list. This code is unique for each widget and acts as a placeholder, telling the system exactly where to insert the widget on your page.
  3. Simply copy and paste this code into the Guesty content editor where you want the widget to appear — for example, in your homepage content or a specific page section.
Find the embed code for a Global or Custom Widget in the Installation section:



Find the embed codes for Property Widgets in the Installation section, by clicking on Embed Codes over the table:


    • Related Articles

    • Widgets

      Explore the articles in this section: Installation: Installing Revyoos Widgets Global Widget Property Widgets Custom Widgets Warnings: Multiple header sections Spammy Structured Markup Penalty Settings: How to Sort Reviews Inside Your Widget ...
    • API Integration with Revyoos

      Note: To access Revyoos API, an active yearly subscription for Business or Business AI plan is required. The complete documentation of the API can be found here: https://www.revyoos.com/docs/ Important Note: API integration is recommended for ...
    • RentalWise Widget Integration

      If you’re using RentalWise as your PMS and you’ve built your website with their website builder, you can easily integrate Revyoos widgets using a special component made for this purpose. However, please note an important detail before you begin: ⚠️ ...
    • Video Tutorials

      Welcome to our video tutorial library. Browse through our collection of step-by-step guides to help you make the most of Revyoos. Add Revyoos Universal Code Using Google Tag Manager This tutorial guides you through adding the Revyoos Universal Code ...
    • Hostfully Widget Integration

      ? How to Install Revyoos Widgets on Your Hostfully Website Revyoos integrates directly with Hostfully, making it easy to manage and display your vacation rental reviews. By simply connecting your Hostfully account with Revyoos, your reviews will ...