> 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/save-and-share-your-work/save-and-share-favorites.md).

# Save and share favorites

Save your analysis points and insights as favorites and share them with your team.

{% hint style="success" %}
[Favorites](/basics/favorites/view-and-save-favorites.md) are one of the key features of Phocas.
{% endhint %}

When you change your view of the grid or filter the data during your analysis, you can save that view as a favorite. You can save multiple favorites and easily switch from one to another for quick access to the information that you need.

{% hint style="info" %}
Some features are linked to the underlying mode settings and might not be available in favorites saved before the feature was introduced. This protects existing favorites from changes that might affect their setup or behavior.

If a new option is missing from a favorite, updating the favorite with your current view should make the option available. If it doesn't, save a new favorite.
{% endhint %}

{% embed url="<https://phocassoftware.wistia.com/s/nybe4kcfv6hfcu2>" %}
Save and share favorites
{% endembed %}

## Learn about favorites in Flex Modes

Favorites work a little differently in Flex Modes than in Analytics.

### Flex favorites on your homepage

In Flex Modes, saved favorites are sometimes referred to as *Flex favorites* to distinguish them from Analytics favorites. On your homepage and side navigation menu, Flex favorites have a different icon. In this page, the term *favorite* refers to favorites saved in Flex Modes unless otherwise specified.

<div align="left"><figure><img src="https://content.gitbook.com/content/aDGOWDU4SqRSiSPGXHgW/blobs/MvwEEysWfc9idCQlAXLU/image.png" alt="" width="436"><figcaption></figcaption></figure></div>

#### Updates

When you make changes to an existing favorite, a pink badge appears on the **Favorite controls** button ![](https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2FnjQg8c44Z1ZvcZcTpWbZ%2Fimage.png?alt=media\&token=685db4f0-8d77-42f8-ba1b-9515771b294e) to remind you to either:

* [update the existing favorite](#update-a-favorite), or
* [save the changes as a new favorite](#save-a-favorite-based-on-an-existing-favorite).

<div align="left"><figure><img src="https://content.gitbook.com/content/aDGOWDU4SqRSiSPGXHgW/blobs/mn9pVIohase7SgisVN29/image.png" alt=""><figcaption></figcaption></figure></div>

When you click the actions arrow, the available options are grouped under headings: **Favorite**, **Alert**, **Dashboards**, and **Administration**. Only the groups that apply to the item you have open are shown. For example, opening an alert created from a favorite shows both the **Favorite** and **Alert** groups together.

### Permissions and sharing

All **database permissions and restrictions** still apply in Flex Modes, regardless of whether you're using a favorite or who created it.

Unlike Analytics, standard **favorites user permissions** don't currently apply in Flex Modes. Users can only manage favorites they own.

#### Favorite owner

The person who created the favorite can:

* View the favorite
* Update the favorite
* Delete the favorite
* Share the favorite
* Create a new favorite based on it

Users the favorite is shared with automatically see updates and lose access if the favorite is deleted.

#### Viewers

When a favorite is shared with a user, they can:

* View the favorite
* Create a new favorite based on it

They can't update, delete, or share the favorite.

### Dynamic periods

Favorites saved with dynamic periods automatically update over time.

For example:

* If Period 1 is set to **Last month** and you save the favorite in December, the favorite displays November data.
* When you open the same favorite in January, Period 1 still shows **Last month**, but the data updates to December.

## Save a new favorite <a href="#save-a-favorite" id="save-a-favorite"></a>

1. Open a database in Flex Modes and carry out your analysis.
2. Do one of the following:
   * Click the actions arrow next to the database name and select **Save as favorite**.
   * Click the **Save as favorite** button ![](https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2FR4jpcjXP8uayzHrdr1aT%2Fimage.png?alt=media\&token=3089fba1-8068-44f3-a96b-d6da50d71318) on the toolbar.

     <figure><img src="https://content.gitbook.com/content/aDGOWDU4SqRSiSPGXHgW/blobs/lz3PjuUaxZhXPDh7KHzj/image.png" alt=""><figcaption></figcaption></figure>
3. Enter a name for the favorite and click **Save**.

   <div align="left"><figure><img src="https://content.gitbook.com/content/aDGOWDU4SqRSiSPGXHgW/blobs/pp3eq9tuRaTcaZ0Ty0gp/Screenshot%202025-08-13%20at%2014.14.29.png" alt="" width="203"><figcaption></figcaption></figure></div>

After saving:

* The favorite name appears next to the database name.
* The favorite button changes to a full heart icon.

<figure><img src="https://content.gitbook.com/content/aDGOWDU4SqRSiSPGXHgW/blobs/93uQOQ5Q5BUx9Gfv3ktR/image.png" alt=""><figcaption></figcaption></figure>

## Save a favorite based on an existing favorite

Use this option to create a variation of an existing favorite, including one shared with you. This creates a separate new favorite.

1. Click either:
   * the actions arrow next to the favorite name, or
   * the **Favorite controls** button ![](https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2FOyOcYX53cDucc1gLLQoG%2Fimage.png?alt=media\&token=33e4ab30-8879-4100-a0c3-2bbd755b372a)
2. Click **Save as new favorite**.
3. Enter a name.
4. Click **Save**.

## Update a favorite

Use this option to overwrite a favorite you own with your latest changes.

1. Click either:
   * the actions arrow next to the favorite name, or
   * the **Favorite controls** button ![](https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2Fu1grJJZACnaCwnIIdVFc%2Fimage.png?alt=media\&token=07f52085-f65c-4315-8ebd-e0e774c183c8)
2. Click **Update favorite**.
3. Optionally change the favorite name.
4. Click **Save**.

## Share a favorite

{% hint style="warning" %}
Flex Modes has a basic [permissions](#permissions) and sharing model, so use caution when sharing favorites.
{% endhint %}

You can share favorites you own with selected users. Shared users can view the favorite but can’t edit or manage it.

1. Click the **Favorite controls** button ![](https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2FNtrLTzDY9c7eUJlFpkmI%2Fimage.png?alt=media\&token=60005065-9d7b-46a3-aa51-afdf03d15be9).
2. Click **Share favorite**.
3. Select the users to share with.
4. Click **Save**.

## Subscribe to a favorite

You can subscribe to a favorite to receive email notifications whenever the underlying data updates.

See [Manage subscriptions](/flex-modes/save-and-share-your-work/manage-subscriptions.md#subscribe-to-a-favorite).

## Delete a favorite

You can delete favorites you own from either of these locations:

**From within the favorite**:

Either click the actions arrow next to the favorite name or click the **Favorite controls** button ![](https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2FmBLchmjrq9MThcu1SF42%2Fimage.png?alt=media\&token=819218e1-c50e-48bb-8719-a099305358b6), then click **Delete favorite** > **Delete**.

**From your homepage**:

Locate the favorite, click its menu button, and then click **Delete** > **Delete**.

* **From within the favorite**: Either click the blue arrow next to the favorite name or click the **Favorite controls** button ![](https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2FmBLchmjrq9MThcu1SF42%2Fimage.png?alt=media\&token=819218e1-c50e-48bb-8719-a099305358b6), then click **Delete favorite** > **Delete**.

**From your homepage**: Locate the favorite, click its menu button, and then click **Delete** > **Delete**.


---

# 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/save-and-share-your-work/save-and-share-favorites.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.