# Share current tab

Give the agent real-time page context — configured in the dashboard, with an SDK override for programmatic control.

Share current tab lets the agent read and interpret the page's content, giving it full awareness of the page's structure and elements so it can guide users based on what's on the page. This is the **page context** the agent reasons over on each turn (see [Context](/guides/context/)).

Turn it on and tune it from your agent's settings in the **dashboard** — that's the primary way to configure it. The SDK settings below are an **override**: use `setConfiguration({ screenSharingSettings })` to control it programmatically, per page or per session, on top of the dashboard defaults.

## SDK override

### active

Enables or disables the Shared Current Tab feature. When `true`, the agent can read and understand the content of the current page to provide contextual assistance, suggest actions, or highlight relevant information without making any changes directly.

- **Type:** `boolean`
- **Default Value:** `false`

### tooltipText

One-line hover label shown on the Agent control. Use this to clearly explain what enabling Shared Current Tab does in a short, non-technical way that reassures users about control and privacy.

- **Type:** `string`
- **Default Value:** `"Let the assistant understand this page and help you."`

### tooltipStarters

Array of up to 2 short suggested prompts shown in the UI to help users quickly start interactions using Shared Current Tab. Hints should be concise, actionable, and reassure users that the agent only reads the page to assist, without modifying it.

- **Type:** `array`
- **Default Value:** `[ "Summarize this", "Explain what I'm seeing" ]`

### shareMode

Determines what type of data the SDK includes when the user shares their screen with the agent. This controls whether the agent receives only an image of the page, only its HTML structure, or both.

- **Type:** `"image" | "html" | "both"`
- **Default Value:** `"both"`

### Example

```javascript
foldspace.agent('YOUR-AGENT-KEY').setConfiguration({
  screenSharingSettings: {
    active: true,
    tooltipText: "Allow the assistant to understand this page and provide helpful suggestions",
    tooltipStarters: [
      "Summarize this page for me",
      "Highlight important information here"
    ],
    shareMode: "both"
  }
});
```