> For the complete documentation index, see [llms.txt](https://docs.phocassoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.phocassoftware.com/flex-modes/change-your-analysis/change-the-stream.md).

# Change the stream

Use the Stream menu to change the stream of data that displays in the grid.

{% hint style="info" %}
User permission: **Query**
{% endhint %}

A stream is a series of data that comes from a particular source. Typically, each business unit or department produces its own stream of data, and these individual streams collectively make up the data in a database.

The available streams depend on the database. For example, in a Sales database, you might have a *Sales Invoices* stream, an *Inventory* stream and a *Budget* stream.

{% columns %}
{% column %}

<div align="left"><figure><img src="https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2F4mdr3yBsAdB4JHhmZqbD%2Fimage.png?alt=media&amp;token=5bb90d79-e5f0-48cf-bf0d-89fe6713e09a" alt=""><figcaption><p>Sales database, Sales Invoices stream (Summary view)</p></figcaption></figure></div>
{% endcolumn %}

{% column %}

<figure><img src="https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2F7fhwMW82ZNW9zv3kZa5z%2Fimage.png?alt=media&amp;token=c1cbe878-bd2d-441f-88f4-9c85c97ab04b" alt=""><figcaption><p>Sales database, Budget stream (Summary view)</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

The default stream displays at the top of the list and is selected when you reset the grid. If there's only one stream in the database, there is no list to select from; the stream name displays in the **Stream** menu.

The selected stream determines which dimensions are available in the dimension panel. For example, the Customer dimension isn't available in the Stock on Hand stream. Similarly, the Warehouse dimension isn't available in the Forecast stream.

{% columns %}
{% column %}

<figure><img src="https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2FGI4Jtvxh7mt79taPEi1M%2Fimage.png?alt=media&amp;token=266d0b57-47ed-4403-b988-51ffe4e78872" alt="" width="184"><figcaption><p>Dimensions in a Forecast stream</p></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2FjGDbjsBMSCwcYEzLSf0I%2Fimage.png?alt=media&amp;token=b086a626-a0a8-48d4-9887-37bdcded5c96" alt="" width="181"><figcaption><p>Dimensions in a Stock on Hand stream</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Change the stream

1. Click the **Stream** menu.
2. Select the stream you want to view.

<div align="left"><figure><img src="https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2FbUSZ7NbZ3nSnVubSFw21%2Fimage.png?alt=media&amp;token=8a9c12ad-ce7d-4cc6-9009-dc58d10f2cf2" alt="" width="202"><figcaption></figcaption></figure></div>

The grid updates to display the data from the selected stream and the **Stream** menu displays its name. You can only select one stream at a time.

{% hint style="success" %}
If you frequently use a stream that isn't the default, save your view as a favorite to keep your stream selection for later.

To return to the default view, click **Reset**.
{% endhint %}

### Do more with streams

You can use streams in other ways to customize your analysis. Explore these related options:

* To compare two streams side by side, and analyze the variance between them, switch to [Stream mode](/flex-modes/change-your-analysis/switch-modes.md#stream-mode). For example, compare actuals against budget.
* To view data from multiple streams in any mode, [add a measure column](/flex-modes/customize-the-grid/manage-columns.md#add-a-measure-column) and select a different stream for that column.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.phocassoftware.com/flex-modes/change-your-analysis/change-the-stream.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
