> For the complete documentation index, see [llms.txt](https://docs.bluefletch.com/bluefletch-enterprise/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/browser/features/multiple-tab-support.md).

# Multiple Tab Support

BF Browser supports multiple tabs, allowing users to have several web pages open simultaneously within a single browser session. Tabs can be created, switched between, and closed independently, providing a familiar desktop-like browsing experience on mobile devices.

<figure><img src="/files/9Fg8ZL5m5WPP3QTOxzzU" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
Multipe-tab support is available in BF Browser version 2.6.0 and higher.
{% endhint %}

## Overview

When multiple tab support is enabled, users can:

* Open multiple web pages in separate tabs (up to a configurable maximum)
* Switch between tabs using the tab bar at the top of the screen
* Close individual tabs or all tabs at once
* Have tabs automatically restored when the app restarts
* Experience memory-efficient tab management with automatic suspension of inactive tabs

{% hint style="info" %}
Multiple tab support is disabled by default to maintain backward compatibility. You must explicitly enable it via configuration to use this feature.
{% endhint %}

## Configuring Multiple Tab Support

### Basic Configuration

To enable multiple tab support, add the following configuration to your Browser settings:

```json
{ 
   "enableTabs": true 
} 
```

### Advanced Configuration

You can customize the tab behavior with additional settings:

```json
{ 
   "enableTabs": true, 
   "maxTabCount": "10", 
   "maxTabsInMemory": "5", 
   "showTabBar": true, 
   "toolbarColor": "#0060A8" 
} 
```

#### Configuration Options:

<table><thead><tr><th width="190.21875">Setting</th><th width="104.81640625">Type</th><th width="126.66796875">Default</th><th>Description</th></tr></thead><tbody><tr><td>enableTabs</td><td>Boolean</td><td>false</td><td>Enable or disable multiple tab support</td></tr><tr><td>maxTabCount</td><td>String</td><td>10</td><td>Maximum number of tabs that can be open simultaneously</td></tr><tr><td>maxTabsInMemory</td><td>String</td><td>5</td><td>Maximum number of WebViews kept in memory (others are suspended)</td></tr><tr><td>showTabBar</td><td>Boolean</td><td>true</td><td>Show or hide the tab bar when tabs are enabled</td></tr><tr><td>toolbarColor</td><td>String</td><td>"#0060A8"</td><td>Color of the tab bar and toolbar (hex color code)</td></tr></tbody></table>

{% hint style="info" %}
The maxTabsInMemory setting controls memory usage. When the number of inactive tabs exceeds this limit, older tabs are suspended (their WebView is destroyed but state is preserved) and automatically restored when switched to again.
{% endhint %}

### User Interface

#### Tab Bar

When multiple tab support is enabled, a tab bar appears at the top of the screen (above the URL toolbar):

* Tab Items: Show the page title and favicon for each tab
* New Tab Button (+): Creates a new blank tab (only visible when allowUrlEdit is enabled)
* Close Button (X): Closes individual tabs
* Scrolling: The tab bar scrolls horizontally when many tabs are open

Tab Behavior •

* Creating Tabs:
  * Tap the "+" button to create a new tab
  * JavaScript calls to window\.open('url', '\_blank') automatically create new tabs
  * Links with target="\_blank" open in new tabs
* Switching Tabs:
  * Tap any tab in the tab bar to switch to it
* Closing Tabs:
  * Tap the "X" button on a tab to close it
  * If the last tab is closed, the app exits (matching the back button behavior)
* Maximum Tabs:
  * When maxTabCount is reached, attempting to create a new tab will show a toast message

{% hint style="warning" %}
Tabs are automatically closed when the device receives a CLEAR\_COOKIES broadcast (typically used on shared devices for user privacy).
{% endhint %}

## Shortcut Specific Configuration

You can opt to enable tabs (similar to other browser settings) at a shortcut level using browser overrides.

```json
{
    "layouts" : {
         "AppGroup" : [      
            {
                "label": "Fiori",
                "url": "https://acme.fiori.com",
                "browser": "com.bluefletch.ems.emm.browser",
                "browserOverrides": {
                    "enableTabs" : true,
                    "toolbarColor" : "#323FD9"
                }   
                
            },
            {   
                "label": "Full Browser",
                "url": "https://google.com",
                "browser": "com.bluefletch.ems.emm.browser",
                "browserOverrides": {
                    "enableEmsApi" : true,
                    "enableTabs" : true,
                    "allowUrlEdit" : true,
                    "toolbarColor" : "#0A3394"
                }   
                
            },  
            {   
                "label": "ServiceNow",
                "url": "https://account.servicenow.com/sign-in",
                "browser": "com.bluefletch.ems.browser"
            }
        ]       
    }
}
```

In the above layout example:

* The **Fiori** shortcut will allow opening of multiple tabs
* The **Full Browser** shortcut will open to google.com, and allow the user to start new tabs and enter a URL, similar to a regular browser experience.
* The **Service Now** shortcut will open in full page, and tabs will not be used. If the page attempts to open a tab, it will replace the current page.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.bluefletch.com/bluefletch-enterprise/product-guides/browser/features/multiple-tab-support.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
