1. Prepare your target Group
You can use either a Floating Group or a regular Group.

Keep the height, background, shadow, spacing, and other visual settings on the Bubble Group itself.

⚠️ Important: Keep This element is visible on page load enabled on the target Group.

If this setting is disabled, Bubble may not create the Floating Group in the page DOM, so the plugin cannot find it.

The plugin automatically hides the Group immediately after initialization.

If you notice a brief flash of the sheet during page load, add Bubble's Hide action in your page-load workflow.

When using a regular Group, also turn off Collapse when hidden.

2. Target the Group

Give the Group an ID or class and enter it in:

• target_id
• or target_class

3. Configure the basic options

Adjust the available options such as:

• Max width
• Top corner radius
• Background scroll lock

Set the corner radius to 0 if you want to keep the Group's existing Bubble radius.

The Free version uses a fixed 40% black backdrop.

4. Always use the plugin actions to open and close the sheet

Use:

• open to show the sheet
• close to hide the sheet

Do not mix these with Bubble's native Show/Hide Group actions, as the plugin state and Group visibility can become out of sync.

5. Use the available state and events

State:

• is_open

Events:

• opened
• closed