# Threads Docs

DocsThreads

[All docs](/docs)

Get Started

-   [Overview](/docs/overview)
-   [How It Works](/docs/how-it-works)
-   [Your First Plan](/docs/your-first-plan)
-   [Post-Install Warm-Up](/docs/post-install-warm-up)
-   [Multi Account Management](/docs/multi-account-management)

Install

-   [Installing Trackingplan](/docs/installing-trackingplan)
    -   [For Websites](/docs/installing-trackingplan/installing-trackingplan-on-your-websites)
    -   [For Apps](/docs/installing-trackingplan/installing-trackingplan-in-your-apps)
    -   [Webhooks](/docs/installing-trackingplan/installing-trackingplan-using-webhooks)
    -   [For ssGTM](/docs/installing-trackingplan/for-ssgtm)
-   [Environments](/docs/environments)
-   [SDK Update](/docs/sdk-update)

The Agent

-   [Threads](/docs/threads)
-   [Reports](/docs/reports)
-   [Audits](/docs/audits)

Use Cases

-   [Investigate a Warning](/docs/debug-warnings)
-   [For Analytics Teams](/docs/analytics-use-cases)
-   [For Performance & Paid Media](/docs/paid-media-use-cases)
-   [For Compliance & Legal](/docs/compliance-use-cases)
-   [For Agencies & Consultancies](/docs/agency-use-cases)

Monitoring

-   [Warnings & Updates](/docs/warning-and-updates)
-   [Data Validation](/docs/data-validation)
-   [Data Layer Monitoring](/docs/data-layer-monitoring)
-   [Consent & Cookie Monitoring](/docs/consent-and-cookie-monitoring)
-   [Privacy Monitoring](/docs/data-privacy-monitoring)
-   [Pixel Monitoring](/docs/pixels-presence-monitoring)
-   [Naming Conventions Monitoring](/docs/naming-conventions-monitoring)
-   [Releases & GTM Monitoring](/docs/autodiscover-releases)

Explore

-   [Explore](/docs/explore)
    -   [Health Summary](/docs/health-summary)
    -   [Data Explorer](/docs/data-explorer)
    -   [Tracks Explorer](/docs/tracks-explorer)
    -   [Presence Map](/docs/presence-map)
    -   [Advanced Views](/docs/advanced-views)
    -   [Session Finder](/docs/session-finder)
-   [Filters & Data Segmentation](/docs/attribution)
-   [Tags](/docs/tags)
-   [Notes & Labels](/docs/notes-labels)
-   [Starred Items](/docs/starred-items)
-   [Sharing](/docs/sharing)

Your Trackingplan

-   [Destinations](/docs/destinations)
    -   [Split Destinations](/docs/split-destinations)
    -   [Events](/docs/events)
    -   [Properties](/docs/properties)
    -   [Attributes](/docs/user-attributes)
    -   [Pages](/docs/pages)
-   [Compliance](/docs/compliance)
    -   [Privacy](/docs/privacy)
    -   [Consent](/docs/consent)
-   [Platform](/docs/platform)
    -   [Daily Checks](/docs/daily-checks)
    -   [Vitals](/docs/platform-metrics)
-   [Acquisition](/docs/acquisition)

Connect

-   [Slack](/docs/slack)
-   [MCP Endpoint](/docs/mcp-endpoint)
-   [Ad Platforms](/docs/ad-platforms)
-   [Trackingplan Exploration API](/docs/trackingplan-exploration-api)
-   [Trackingplan Export API](/docs/trackingplan-export-api)
-   [Data Studio Connector](/docs/trackingplan-connector-for-data-studio)
-   [Chrome Extension](/docs/trackingplans-chrome-extension)
-   [Omnibug Extension](/docs/trackingplan-omnibug-extension)

Account & Security

-   [Settings & Members](/docs/settings)
-   [Privacy & Security](/docs/privacy-and-security)
-   [JSON Export/Import](/docs/export-import-json-schemas)

[The Agent](/docs) Updated October 15, 2026

# Threads

Ask the Trackingplan agent about your tracking data in a thread, follow the queries behind each answer and share the thread with your team.

> A thread is a conversation with the Trackingplan agent. Ask about your tracking data (events, destinations, campaigns, warnings) and the agent answers from the raw traffic of your plan. Open **Threads** from the menu.

![The Threads screen: the list on the left and a new thread on the right](/images/docs-threads-overview.png)

The Threads screen: the list on the left and a new thread on the right

## The thread list

The list on the left holds your threads and the ones shared with you. Each one shows its title, its visibility (**Private**, ** Everyone** or ** Public**), its owner and when it was last updated.

-   **Search threads**, at the top of the screen, finds a thread by its title.
-   **All** filters the list: ** All**, ** Starred**, ** Private**, ** Shared with me** or ** Shared by me**.
-   **Updated** sorts it by ** Updated**, ** Name**, ** Owner** or ** Visibility**.

Hover a thread and click **…** to ** Star**, ** Share**, ** Rename** or ** Delete** it.

## Start a new thread

Click **New thread**, or press ** ⌘⇧K** from any page. The empty thread asks "What do you want to analyze?" and suggests three questions to get you going. Click one, or write your own in ** Ask anything about your data…** and send it.

Next to the box:

-   **Auto** chooses the model. ** Auto** picks one for each question; you can also choose ** Max intelligence**, ** Balanced** or ** Fast**.
-   **+** adds context to the question:
    -   **Attach file**: ask about a screenshot or a file beside your data.
    -   **Items**: name an event or a destination to start from.
    -   **Report mode**: get the answer as a report worth keeping. See [Reports](/docs/reports).
    -   **Audit mode**: turn the question into a saved audit. See [Audits](/docs/audits).

![The + menu of the question box](/images/docs-threads-add-menu.png)

The + menu of the question box

The line under the box shows a tip. A useful one: tell the agent facts like "the Meta pixel was retired", and it keeps them in mind for everyone on the plan.

## An open thread

Click a thread and it opens beside the list. The header shows its title, visibility, owner and date, and three controls:

-   **Share** sets who can see the thread (see below).
-   **…** lets you ** Rename** it, ** Add to starred**, open its ** Analytics** or ** Delete** it.
-   The arrow icon opens the thread as a page.

Keep the conversation going in the box at the bottom. In a thread someone shared with you, **Continue in a private thread** copies the conversation into a thread of your own.

## How an answer looks

Each answer starts with a line such as "Worked for 1 min 49 secs" and the number of queries the agent ran. Click it to see how the agent got there: what it was thinking, each SQL query with the rows it returned, and the data it read.

![The steps behind an answer: each query and the rows it returned](/images/docs-threads-steps.png)

The steps behind an answer: each query and the rows it returned

Then comes the answer. When a warning affects the figures, a **Data quality** note under the answer tells you how, and how far you can trust the number.

![An answer with its Data quality note](/images/docs-threads-answer.png)

An answer with its Data quality note

Under each answer:

-   Thumbs up and thumbs down to rate it, and a button to copy it.
-   Suggested follow-up questions. Click one to ask it.

After some answers, the agent offers **Turn this answer into a report?**: click ** Yes** to get it as a report, ** No** to skip it, or ** Don't suggest again**.

When the agent needs a decision, it asks with a short list of options to pick from. When it creates a report or an audit, the thread shows it as a card with **Open report** or ** Open audit**.

## Your questions

Hover one of your questions to **Copy the question**, ** Resend** it or ** Edit** it. When a question has more than one version, the arrows next to it move between them (** Previous version**, ** Next version**).

## Share a thread

**Share** offers three levels:

-   **Private**: only you.
-   **Everyone**: everyone with access to this plan.
-   **Public link**: anyone with the link, no sign-in.

**…** > ** Analytics** shows who viewed the thread, which version and when, and its downloads.

## Limits

-   Questions about traffic, consent and spend cover the last 90 days at most.
-   The agent opens a public page of your site in a browser only with your approval.

## Related

-   [Reports](/docs/reports)
-   [Audits](/docs/audits)
-   [Sharing](/docs/sharing)
-   [Investigate a Warning](/docs/debug-warnings)

[← Previous**Keeping Your SDK Updated**](/docs/sdk-update) [Next →** Reports**](/docs/reports)

Was this useful? Write to [support@trackingplan.com](mailto:support@trackingplan.com)

On this page

1.  [*01*The thread list](#the-thread-list)
2.  [*02*Start a new thread](#start-a-new-thread)
3.  [*03*An open thread](#an-open-thread)
4.  [*04*How an answer looks](#how-an-answer-looks)
5.  [*05*Your questions](#your-questions)
6.  [*06*Share a thread](#share-a-thread)
7.  [*07*Limits](#limits)
8.  [*08*Related](#related)
