Component configuration options

This page describes every widget option with examples so you can tailor it to your needs.

What you'll learn

• Which parameters are required and how they relate to the booking view.
• How to configure the floating button, modal, and button selectors.
• How to pass extra parameters and UTM tags for marketing.

Required parameters

type (string)

Component type. Defaults to location_profile. Supported values:

• location_profile: Loads a venue profile.
• location_services: Displays the list of services available at a venue.
• location_service_category: Displays service categories at a venue.
• location_classes: Shows class schedules for a venue.
• business_profile: Loads all venues for a business profile.

Example:

RSConfig = {
  type: 'location_services',
};

---

slug (string)

Unique identifier for the data or service to load.

Example:

RSConfig = {
  slug: 'my-unique-location',
};

---

Optional parameters

language (string)

Component language. If omitted, the browser language is used. Supported values:

• 'bg' (Bulgarian)
• 'en' (English)
• 'de' (German)
• 'es' (Spanish)
• 'it' (Italian)
• 'fr' (French)
• 'tr' (Turkish)
• 'ro' (Romanian)
• 'el' (Greek)
• 'mk' (Macedonian)
• 'ru' (Russian)

Example:

RSConfig = {
  language: 'en',
};

---

sticky_button (Object)

Floating button settings.

Properties:

• text (string): Button text.
• text_color (string): Text color, e.g., #FFFFFF or red.
• background_color (string): Background color, e.g., #000000 or blue.
• tooltip_text (string): Tooltip text.
• tooltip_expire_time (number): Tooltip expiration in seconds.
• tooltip_show_delay (number): Delay before showing tooltip in seconds.
• position (string): Button position. Supported values:
  • top-left, top-middle, top-right
  • right-top, right-middle, right-bottom
  • bottom-left, bottom-middle, bottom-right
  • left-top, left-middle, left-bottom

Example:

RSConfig = {
  sticky_button: {
    text: 'Click me!',
    text_color: '#FFFFFF',
    background_color: '#0000FF',
    tooltip_text: 'Any questions?',
    tooltip_expire_time: 3600,
    tooltip_show_delay: 2,
    position: 'bottom-right',
  },
};

---

modal (Object)

Modal window settings.

Properties:

• max_width (string): Maximum width (e.g., 500px or 90%).
• max_height (string): Maximum height (e.g., 500px or 90%).

---

Request parameters

Pass additional parameters using parameters:

var RSConfig = {
  type: 'location_services',
  slug: 'your-location-slug',
  parameters: {
    category: '123',
    services: '123,124',
  },
};

Supported parameters:

Parameter	Type	Description	Example
category	string	Display a category	'123'
services	string	Comma-separated list of service IDs to display as selected	'123,124'

---

UTM parameters

Track marketing campaigns under utm:

Option	Type	Description
source	string	Traffic source
medium	string	Traffic medium
campaign	string	Campaign name
content	string	Content identifier
term	string	Search term

The widget automatically detects UTM parameters from the URL and stores them in local storage. They are used for all interactions until they expire (default: 1 hour). If not provided, defaults are used: source: 'reservation.studio', medium: 'js-widget'.

---

Data attribute overrides

You can override slug, language, utm, and request parameters via data attributes on trigger elements. For request parameters, use the form data-parameters-{name}. Nested parameters can be expressed by chaining names with hyphens.

Full list of options: Component options.