---
title: Bubble (floating button) settings
description: "Learn how to set up and configure the VoxWrite floating button (bubble) for quick access to voice recording on any webpage. Configure behavior settings, add bubble for specific websites, and manage your bubbleβ¦"
canonical: https://voxwrite.app/docs/bubble-settings
locale: en
---
# Bubble (floating button) settings
> Markdown twin of https://voxwrite.app/docs/bubble-settings
> Fetch this instead of the HTML page: same content, a fraction of the bytes.
> Site structure and the full page list for agents: https://voxwrite.app/llms.txt
Learn how to set up and configure the VoxWrite floating button (bubble) for quick access to voice recording on any webpage. Configure behavior settings, add bubble for specific websites, and manage your bubbleβ¦
## Setting Up the Bubble (Floating Button)
The bubble (also called floating button) is a convenient way to access VoxWrite's recording from anywhere on a webpage.
## What is the Bubble?
The bubble is a floating button that appears on your screen and follows you as you scroll. It provides quick access to VoxWrite's voice recording features.
**Key features:**
- π― **Always accessible** - Appears on any webpage where you've configured it
- π±οΈ **Drag to move** - Position it anywhere on your screen
- π **Quick actions** - Double-click to start recording, hover for menu
- π **Stays in place** - Remembers your preferred position
**How to use the bubble:**
- **Drag** - Click and drag to move it anywhere
- **Hover** - Hover to see expanded controls
- **Double-click** - Start recording immediately (if Auto-Start is enabled)
---
## Repositioning the Recording Overlay
The recording overlay can be moved. You can reposition it anywhere on the screen that's convenient for you.
**To reposition the overlay:**
1. Hover on the bubble with your mouse
2. Click the **"Position Overlay"** button from the dropdown menu
3. Drag and drop the window to any location on your screen
The overlay will remember your chosen position and open in that location going forward.
## Step 1: Configure Behavior Settings
Before setting up your bubble, configure how it behaves when you interact with it.
### Opening Behavior Settings
1. Click the **VoxWrite icon** in your Chrome toolbar
2. Go to **Settings**. To do this, click the VoxWrite extension icon in your browser toolbar, then click the gear icon in the top-right corner.
3. Navigate to the **"Behaviour"** tab
---
### Available Behavior Options
#### **Fallback Copy & Paste**
When text insertion fails, automatically copy the text to clipboard as a fallback.
**Options:**
- β
**Enabled** - Text automatically copied to clipboard if insertion fails
- βοΈ **Disabled** - No automatic copying
**When to enable:**
- β
Some websites block automatic text insertion
- β
You want a backup method to get your text
- β
You prefer manual control over where text goes
**How it works:**
1. VoxWrite tries to insert text directly into the field
2. If that fails (website blocks it), text is copied to clipboard
3. You can manually paste it wherever you need
---
#### **Auto-Start Recording** β
Automatically start recording when the overlay opens.
**Options:**
- β
**Enabled** - Recording starts immediately when you open the overlay
- βοΈ **Disabled** - You must manually click the record button
**When enabled:**
- Double-click the bubble β Recording starts immediately
- Click any microphone icon β Recording starts automatically
- No need to click "Start Recording" button
**When to enable:**
- β
You want the fastest possible workflow
- β
You're ready to speak as soon as you click
- β
You use VoxWrite frequently throughout the day
**When to disable:**
- β You need time to prepare before speaking
- β You want to review settings before recording
- β You're in a noisy environment and need to time your recording
**Note:** Recording will start automatically when you open the recording overlay.
If you double-click the floating button and see such notice, it means that microphone use is likely prohibited in the privacy policy of this website and floating button may not work properly. In this case, use [recording through the Side Panel.](https://voxwrite.app/docs/start-recording)
---
## Step 2: Set Up Bubble for Specific Websites
Now configure where and how the bubble appears.
### Opening Bubble Settings
In the **Behaviour** tab, scroll down to **"Bubble Settings"** section.
Add a setting to configure bubble behavior for specific websites.
---
### Adding a New Bubble Setting
Click the **"+ New"** button to create a bubble configuration.
---
#### **Fill Out the Form:**
##### 1. **Name (Optional)**
Give your bubble setting a memorable name.
**Field:** `Name (Optional)`
**Examples:**
- `Google Docs`
- `My Workspace`
- `Gmail Bubble`
- `Social Media Sites`
**Tips:**
- β
Use website name for easy identification
- β
Be descriptive if covering multiple sites
- β Can leave blank - VoxWrite will use the site URL as the name
---
##### 2. **Site** (Required)
Enter the website domain or URL pattern where this bubble should appear.
**Field:** `Site *` (required)
**Placeholder:** `e.g., docs.google.com, example.com`
**Examples:**
| Website | What to Enter | Result |
| --- | --- | --- |
| Google Docs | docs.google.com | Bubble appears on all Google Docs pages |
| Gmail | mail.google.com | Bubble appears in Gmail |
| All Notion pages | notion.so | Bubble appears on any Notion workspace |
| LinkedIn | linkedin.com | Bubble appears across LinkedIn |
| Specific subdomain | app.example.com | Bubble only on that specific subdomain |
**Pattern matching:**
- Enter just the domain (e.g., `gmail.com`)
- Don't include `https://` or `www.`
- Use specific URLs for precise targeting
- One domain per bubble setting
---
##### 3. **Save Your Setting**
Click **"Create Setting"** button (bottom right) to save.
**Or:**
- Click **"Cancel"** to discard
---
### Example: Setting Up Bubble for Google Docs
Let's create a bubble that appears on Google Docs:
1. Click **"+ New"** in Bubble Settings
2. **Name:** `Docs`
3. **Site:** `docs.google.com`
4. Click **"Create Setting"**
**Result:** The bubble will now appear whenever you open a Google Doc.
---
## Step 3: Managing Your Bubble Settings
After creating bubble settings, you'll see them listed in a table.
---
### Editing a Bubble Setting
To modify an existing bubble configuration:
1. Find the bubble setting in the list
2. Click the **Edit icon** (pencil) in the Actions column
3. Modify the **Name** or **Site** fields
4. Click **"Save Changes"**
---
### Deleting a Bubble Setting
To remove a bubble configuration:
1. Find the bubble setting in the list
2. Click **twice** the **Delete icon** (trash) in the Actions column
**Warning:** This action cannot be undone. The bubble will immediately stop appearing on that website.
---
### Toggling Visibility
You can temporarily hide/show bubbles without deleting them:
1. Find the bubble in the list
2. Look at the **Visibility** column
3. Click the status badge to toggle between:
- **Visible** - Bubble is active and appears on the website
- **Hidden** - Bubble is disabled but setting is saved
**When to use Hidden:**
- Temporarily disable bubble without losing configuration
- Test how a website works without the bubble
- Switch between different bubble configurations
---
## Free Plan Limitation
**Important:** If you have a **Free pricing plan**, you can configure only **one bubble setting**.
**What this means:**
- β
You can create one bubble for one website
- β Cannot add multiple bubble settings
- β
You can edit or change which website it's on
- β
You can delete and create a new one
**To configure bubble for multiple websites:**
- Upgrade to a paid plan
- Or manually switch your one bubble setting between different websites as needed
**Upgrade benefits:**
- Unlimited bubble settings
- Configure different bubbles for different websites
- Each website can have customized bubble behavior
---
[{"<<"} Configuring custom rules](https://voxwrite.app/docs/custom-rules) **|**
Configuring hotkeys {">>"}
## Related
- HTML version of this page: https://voxwrite.app/docs/bubble-settings
- Site map for agents: https://voxwrite.app/llms.txt