# Use layouts

{% hint style="info" %}
User permission: Budgets & Forecasts
{% endhint %}

Layouts are a great way to instantly change your view of a worksheet. They are different configurations of a budget or forecast worksheet. A layout can include dimension filters, search results and/or the status of the workflow column (whether it is expanded, collapsed or partially expanded).

For example, suppose your business operates in three countries (Australia, the USA and the UK) and you have one budget workbook with data for all three countries. You can apply a filter to view the budget for Australia only and save that view as a layout. You can then repeat that step to save layouts for each of the other two countries, to create four layouts in total; the original consolidated budget and one for each country.

## Save a layout <a href="#uselayouts-savealayout" id="uselayouts-savealayout"></a>

1. Set up (configure) the worksheet in a particular way. For example, you might want to apply a filter, search for a specific item and/or expand the workflow column.
2. Click **Layout None** > **Save as new custom layout…** above the grid.

   <div align="left"><figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/mHTBFZNSVmjWKwRPDCSa/3170369584.png" alt="" width="102"><figcaption></figcaption></figure></div>
3. Enter a name for the layout.
4. Determine who can use the layout. Learn more about sharing layouts in the next section.
5. Click **Save**.

   <div align="left"><figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/fNvmpm5t0ai5sSdt7TDP/3170500667.png" alt="" width="170"><figcaption></figcaption></figure></div>

## Share a layout <a href="#uselayouts-sharealayout" id="uselayouts-sharealayout"></a>

You can share a layout with one or more other users when you first save a layout or later, via the layout’s **Share** button. You have three sharing options:

* **Only me**; Do not share your layout with anyone; keep it for your personal use only.
* **Everyone**: Share your layout with all users who have access to the worksheet.
* **Selected users**: Share your layout with a subset of the users who have access to the worksheet. When you select this option, you can select one or more Budgets & Forecasts users from the list that displays.

  <div align="left"><figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/fHNo4d8MrwmPrnYLD4Ni/3170500776.png" alt="" width="170"><figcaption></figcaption></figure></div>

Layouts work alongside your organization’s workflow practice and workbook access, as the sharing of layouts works differently, depending on your user role:

* Budget contributors: When you share a layout with a user, that user will only have access to the layout after they have been assigned a row in the worksheet’s workflow.
* Budget owners and administrator: When you share a layout with a user, you give that user view-only access to the budget or forecast workbook. That user can later be assigned a row in the workflow as usual.

In the following example, the budget administrator created four layouts for a worksheet and only shared one of them with Bill Branchmanager. He assigned Bill some rows in the worksheet. When Bill opens the worksheet, he sees the shared layout in his **Layouts** menu. He can apply that shared layout but cannot edit or delete it. He can also create his own layouts.

<div align="left"><figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/yng2Zn4k0THYY2hMxXmU/3170402478.png" alt="" width="374"><figcaption></figcaption></figure></div>

## Apply a layout <a href="#uselayouts-applyalayout" id="uselayouts-applyalayout"></a>

The **Layouts** menu displays a list of all the layouts you saved and any that have been shared with you. You can switch between different layouts to quickly change your view of the worksheet.

Click the **Layouts** menu and select the layout you want to apply.

## Edit a layout <a href="#uselayouts-editalayout" id="uselayouts-editalayout"></a>

You can edit the name, sharing settings and configuration of any layouts that you create. Your changes flow through to any users you have shared the layout with. You cannot edit a layout that has been shared with you. All of the editing options are available in the **Layouts** menu.

<div align="left"><figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/abYnDqGeAIa8J25XIbEb/3170173169.png" alt="" width="272"><figcaption></figcaption></figure></div>

To edit the layout’s name or sharing settings, click its **Share** button, make your changes, then click **Save**.

<div align="left"><figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/n4Q4BZhdTDeGSk3dZQ7N/3170173182.png" alt="" width="302"><figcaption></figcaption></figure></div>

To intentionally edit the layout’s configuration, click the **Edit** button before the layout name, make your changes, then click the **Save** button that displays after the layout name.

<div align="left"><figure><img src="https://content.gitbook.com/content/aNH5UMuZXBHuAbFF7nI2/blobs/4s98DRSi1OAQv6SNDKH1/3170238702.png" alt="" width="105"><figcaption></figcaption></figure></div>

If you unintentionally make a change to a layout’s configuration, you can either save your changes as a new custom layout (and leave the original intact) or revert to the default layout (discard all changes).

## Delete a layout <a href="#uselayouts-deletealayout" id="uselayouts-deletealayout"></a>

When you delete one of your layouts, it is instantly removed from the list of layouts and no longer available for other users to apply (if it had been shared).

Click the **Layouts** menu, then click the **Delete** button next to the layout.


---

# Agent Instructions: 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:

```
GET https://docs.phocassoftware.com/budgets-and-forecasts/contributor/customize-your-view/use-layouts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
