Webmaster Guide to RGP Web Widgets

Rock Gym Pro (RGP) web widgets allow you to display offerings, schedules, and events on your website and accept online bookings and payments. This guide walks through how widgets work, how to choose the right setup, and how to implement them successfully from start to finish.

What RGP Web Widgets Do

RGP widgets let customers:

• Browse your offerings and events

• Book online from your website

• Complete payment using Stripe

Widgets can either be:

• Linked to from your website, or

• Embedded directly into your website pages

Both options work on desktop and mobile, with some important behavior differences covered later in this article.

Before You Start: Requirements Checklist

Before adding RGP web widgets to your website, confirm the following requirements are met.

Payment processing

• Stripe is connected to your RGP database for online payments

• If Stripe is not set up, contact RGP Support before continuing

Activate Your Online Group Key

• A waiver form must be published to enable the Online Group Key and online widget functionality

• The waiver does not need to be public-facing

• You may publish the waiver and then mark it as inactive or hide it from the top-level form list

• If you haven't published a Rock Gym Pro or Smartwaiver form yet, follow the directions in this support article to make one: Adding a New Waiver Form

RGP Calendar Settings

In Calendar → Manage Schedule → Settings, confirm:

• Business name, address, phone, website, and email

• Time zone (this is critical for correct scheduling)

• Currency and regional settings

• Logo

These can be found in the first three tabs of Calendar/Booking Settings.

Website platform and access

• You must be able to add links or embed code into your website

• For embedded widgets, access to page HTML or a CMS embed block is required

Important platform note:

• Embedded RGP widgets use iframe technology

• Some website platforms and themes restrict or block iframes

• Platforms that rely heavily on iframe-based themes, such as Wix, may not support embedded widgets

If your website platform has iframe limitations:

• Embedded widgets may not load or may behave inconsistently

• RGP Support cannot override platform restrictions

• Using direct widget links is the recommended and fully supported approach

RGP Widget Types

Before deciding how to add widgets to your website, decide what you want customers to see.

RGP offers three widget types: Single offering widgets, catalog widgets (multiple offerings in a browsing setting), and calendar widgets (multiple offerings in a schedule setting).

NOTE:  Please do not actually complete test bookings at the sites below as they are live databases.  You can browse and enter information, just please don’t complete the bookings!

Single Offering widget

Displays one specific offering only.

Use this when:

• You want customers to book one specific program

• You are linking from a marketing page or email

• You do not want customers browsing other offerings

Customers cannot navigate to other offerings from this widget.

Example: Single Offering Widget, using direct link method (read more about integration methods below)

Catalog widget (browse multiple offerings)

Displays multiple offerings organized into categories.

Use this when:

• You want customers to browse options

• You have multiple programs or experiences

• You want a primary “Book Now” experience

This is the most commonly used widget type for multiple offerings.

Example: Catalog Widget, using embedded method

Calendar widget (schedule view of multiple offerings)

Displays offerings and events in a calendar layout.

Use this when:

• Schedule visibility matters more than categories

• You run event-driven or time-specific programming

• Customers choose based on dates first

Example: Calendar Widget, using embedded method

Website Integration Methods

There are three methods to use the booking or online gift card widgets on your facility’s website

Direct Links (simplest)

You place a link or button on your website that opens the widget on RGP’s hosted pages.

Best for:

• Fast setup

• Email campaigns or social media links

• Websites where embedding is not possible

Key notes:

• Widgets open on RGP hosted pages

• Branding still reflects your facility

Single embedded widget (most common)

You embed one main widget, usually a Catalog widget, into a single page on your website.

Best for:

• A dedicated “Book Now” page

• Keeping customers fully on your site

Key rule:

• Only one embedded booking widget per page

Multiple embedded widgets (advanced)

You embed different widgets on different pages of your website.

Best for:

• Larger sites

• Separate pages for different programs

Key rule:

• Only one embedded booking widget per page

Example: Multiple Classes w/ links to embedded widgets

Additional setup is required when linking into multiple embedded widgets. This is covered later.

Getting Widget Code in RGP

To find widget links or embed code:

1. Go to Calendar → Manage Schedule → Online Widgets

2. Select a widget

   • Catalog and Calendar widgets appear at the top

   • Single Offering widgets appear at the bottom

3. Preview the widget
   

4. Open the Website Widget Code tab

5. Copy the direct link or embed code
    

Multiple embedded widgets method

Repeat the single embedded process for each widget and page.

To link into a specific embedded widget page, append a callback URL parameter to the widget link:

&callbackurl=YOURPAGEURL

If needed, URL encode the callback URL.

Important notes:

• Only one embedded widget is allowed per page

• Callback behavior may be affected by browser tracking restrictions, especially on Apple devices

Mobile Behavior and Browser Requirements

• Direct links open responsive widgets that adapt automatically on mobile

• Embedded widgets may open the booking flow in a new browser tab on mobile devices

Opening a new tab on mobile is expected behavior and improves form usability.

Prevent embedded widgets from opening a new tab

To override the default mobile redirect behavior, use the Responsive Mode code instead, which adds a special script at the beginning. 

<script id="rgp_never_redirect_script_id" ...></script>

Use the exact embed code provided by RGP.

Cookie and browser requirements

RGP widgets rely on standard browser cookies and tracking behavior.

Customers must:

• Have cookies enabled

• Allow cross-site tracking for full callback behavior

Important browser notes:

• Apple Safari and iOS devices use Intelligent Tracking Prevention (ITP)

• ITP may block callback URLs or returning to a specific embedded widget page

• This is browser behavior, not an RGP error

Most customers complete bookings without changing browser settings. You can read more about browser cookie requirements here: Browser Cookie Requirements for Online Booking Widgets

Multi Location (Multigym) Setup

RGP does not include built in location switching inside widgets.

Common approaches:

• Create one Catalog widget per location

• Place each widget on its own page

• Link from a main “Book by Location” or “Locations” page

Testing Your Setup with Browser Test Mode

RGP includes a browser based test mode that, when paired with the Browser Kiosk Mode link, allows bookings without requiring a credit card.

Browser Kiosk Mode links can be found on the Website Widget Code tab. 

After navigating to the Browser Kiosk Mode URL, you can click on the links below to enable or disable test mode.

Enable test mode:

https://app.rockgympro.com/b/testmode.php?on

Disable test mode:

https://app.rockgympro.com/b/testmode.php?off

Notes:

• Test mode applies only to the browser where it is enabled

• Keep test mode links private