# Manage favorites

After you save a favorite, other actions become available. These actions require additional user permissions.&#x20;

{% hint style="info" %}
Administrators with the **Favorites** permission can access the [**Favorites** page](https://app.gitbook.com/s/vQCmtGTR7MsjcI62Vdki/favorites-administration), where they can manage all the favorites in your organization’s Phocas site.
{% endhint %}

## Edit a favorite <a href="#modify-a-favorite" id="modify-a-favorite"></a>

{% hint style="info" %}
User permissions: **Save Favorites** to edit your own favorites; **Manage Favorites** to edit favorites shared with you.
{% endhint %}

You can modify and re-save (overwrite) your own favorites. You can't overwrite a favorite shared with you, unless you use the **Save as new favorite** method described above.

### Edit a favorite's name, description, or owner

You might want to change the name or description of one of your favorites or transfer the ownership so that another user can manage it. Changing the owner is especially important if you leave the business because if your Phocas account is deleted, the favorites you created will no longer be available to other users. &#x20;

You can quickly edit a favorite's name, description, and owner from your homepage. Locate the favorite and click its menu button, then click **Edit**. Make your changes and click **Save**.

You can also edit these details from within the favorite, as described in the next section.

<div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2Fgit-blob-f1515bfbda673f0f2f4545ae08152ce0494c1d3f%2F3504046254.png?alt=media" alt="image-20240520-221013.png" width="642"><figcaption></figcaption></figure></div>

### Edit a favorite's contents

Editing the contents of a favorite is similar to saving a new one. For example, suppose you saved a favorite with a list of 10 key accounts and now want to add another account. &#x20;

1. Open the favorite.
2. Modify that favorite as required. For example, you might select and focus on another dimension.
3. Click the blue arrow next to the favorite name and select **Save**.

   <div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2Fgit-blob-c5f5e25c3d6ea69b9f2a91bd6ddff56e437aa9d3%2F3205890211.png?alt=media" alt="" width="340"><figcaption></figcaption></figure></div>
4. Edit the favorite’s name, description, and other settings as required. Phocas recognizes you're modifying an existing favorite and displays these saved settings for you.&#x20;
5. Click **Save**. The contents of the existing favorite are modified, but the other settings remain the same (unless you changed them too).

## Add a favorite to the dashboard <a href="#saveafavorite-addafavoritetothedashboard" id="saveafavorite-addafavoritetothedashboard"></a>

Favorites are a great way to add content to a [dashboard](https://docs.phocassoftware.com/basics/dashboards/create-a-dashboard#add-content-to-a-dashboard). The favorite, which can be in a grid or chart view, is displayed inside a dashboard widget. See [Add a favorite as a widget](https://docs.phocassoftware.com/basics/dashboards/create-a-dashboard#add-a-favorite-as-a-widget) for steps.

## Create an alert from a favorite

Alerts are favorites that are configured with color coding to help you monitor performance against set targets. They are displayed on your homepage, where the color identifies items that require your immediate attention. See [Use alerts](https://docs.phocassoftware.com/basics/favorites/use-alerts) for more information.

## Share a favorite

{% hint style="info" %}
User permissions: Collaboration > Share with Folders and/or Share with Users.
{% endhint %}

Read the [Sharing and folders](https://docs.phocassoftware.com/basics/getting-started/sharing-and-folders) page to learn about how sharing works.

Typically, you share a favorite when you create it. At the bottom of the **Favorite** window, select the checkboxes of the required folders and users, then click **Save**.

<div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2FI54l67W6aAI7gIwYOulZ%2Fimage.png?alt=media&#x26;token=ecf03f87-7e43-4e15-a9a5-79d07e6edcf3" alt="" width="310"><figcaption></figcaption></figure></div>

<details>

<summary>Example: Save and share a favorite</summary>

For example, suppose you create a pie chart comparing the profit last month in each territory. You now want to save the chart as a favorite and share it with the sales team by placing it in a sales folder. You also want the favorite to automatically update with new data as time goes on.

1. Select **Actions  > Save**.
2. Select **New** from the **Favorite** dropdown list, if not already selected.
3. Enter the name as *Territory Profitability* and leave the description blank.
4. Leave the period as Current (Previous Month).
5. Select the **Sales** folder.
6. Do not select any individual users. The favorite will be automatically shared with you as you are the owner.
7. Click **Save**.

   <div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2Fgit-blob-c5ccc4bb7188579fd470816fda65f9649e525dd2%2F3033890979.png?alt=media" alt="" width="374"><figcaption></figcaption></figure></div>

</details>

You can also share a favorite from your homepage. Locate the favorite, then click its menu button and click **Share**. In the **Share** window, select the required users and/or folders, then click **Save**.

<div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2FG1DbQlOi1l2V4crDAUsa%2Fimage.png?alt=media&#x26;token=92d85599-70ca-432b-995d-bde983fb1ce4" alt="" width="371"><figcaption></figcaption></figure></div>

### Share an embeddable link <a href="#shareadashboard-shareanembeddablelink" id="shareadashboard-shareanembeddablelink"></a>

You can generate a link for embedding a favorite into another website (such as an intranet, or another product) for authenticated users to view.

<details>

<summary>Steps</summary>

When the item is open, click the **Export** button in the toolbar, then select **Embed view** and click **Export**.

![](https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2FBcpCIHnbvr0Fo0TqVcQh%2Fimage.png?alt=media\&token=13f2a4a8-9183-4c60-bce9-105ee94c5218)

A new browser window opens with a unique embeddable URL, which you can then copy and paste into another application (the steps you need to take depend on the application you are using). In some cases, you need to put the URL inside an iframe HTML tag. For example, the code snippet might look like this:

`<iframe src="https://yourphocassiteurl.phocassoftware.com/Favourite/Embed/58" height="500" width="500"></iframe>`

In the example below, a favorite was embedded into another location and then opened by a user. You can see it looks a bit different in the embed view; the black bar, logo, and other Phocas tools are absent. Authenticated users can open the favorite to analyze the data in Phocas.

<img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2Fgit-blob-85b7f4b45bdf033f99e2beb549c7a4a19636eee9%2F3033989305.png?alt=media" alt="" data-size="original">

</details>

## Subscribe to a favorite

{% hint style="info" %}
User permission: Favorites > Subscribe
{% endhint %}

Subscribe to favorites to receive email notifications whenever they're updated. See the [Subscriptions](https://docs.phocassoftware.com/basics/getting-started/subscriptions) page for steps.

<div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2Fgit-blob-3f239359b0a5bd0f006c7b3710f4a75afefb6fb2%2F3205890272.png?alt=media" alt="" width="204"><figcaption></figcaption></figure></div>

## Delete a favorite

{% hint style="info" %}
User permissions: **Save Favorites**
{% endhint %}

You can delete the favorites that you create (own).&#x20;

On your [homepage](https://docs.phocassoftware.com/basics/getting-started/homepage), locate the favorite, click its menu button, and then click **Delete** > **Delete**. You can restore it within 45 days from the **Deleted items** tab.

If you have many shared favorites cluttering your homepage, rather than deleting them, use the grid filters to remove them from view.
