> ## Documentation Index
> Fetch the complete documentation index at: https://docs.curator.interworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Favorites

> Enable user favoriting functionality to personalize homepages and prioritize frequently accessed content.

Curator has the ability to mark dashboards as favorites.  Favorited dashboards will show up first on the home page once
the user logs in.

This functionality requires any authentication method other than "Pass-Through".  See the [Authentication Methods](https://docs.curator.interworks.com/setup/authentication/overview.md)
section for more information.

If you have a [Tableau Connection](https://docs.curator.interworks.com/creating_integrations/tableau_connection/creating_a_connection.md)
the favorites will also synchronize across to Tableau Server/Cloud.

You can also display the number of favorites a Dashboard has. This number shows up in both the Dashboard action-buttons
area when viewing a Dashboard and on the homepage when showing Dashboard tiles.

## Enabling Favorites

1. In the [backend of Curator](https://docs.curator.interworks.com/site_administration/accessing_the_backend.md) using the left-hand navigation,
   navigate to the
   **Settings**
   \>
   **Curator**
   \>
   **Portal Settings** page.

   On the  page
   click the **Features** tab
   and
   expand the **Toolbar Buttons (Tableau Actions)** section.
2. Find the "Favorites" setting and toggle it on.
3. Be sure to save your changes.

## Favoriting a Dashboard

1. Navigate to the frontend of the system (e.g. `http://curatorexample.com`).
2. Log in if prompted.
3. Navigate to the desired Dashboard by using the navigation menu.
4. Click on the star icon at the top right portion of the screen. Normally this is displayed on the right side of the
   title bar in the Dashboard.

When [Beta Search](https://docs.curator.interworks.com/site_content_design/content_discovery/search.md#beta-search) is enabled, you can also favorite or
unfavorite dashboards and pages from the search window. Click the star next to a search result.

## Showing the Number of Favorites

1. In the [backend of Curator](https://docs.curator.interworks.com/site_administration/accessing_the_backend.md) using the left-hand navigation,
   navigate to the
   **Settings**
   \>
   **Curator**
   \>
   **Portal Settings** page.

   On the  page
   click the **Features** tab
   and
   expand the **Toolbar Buttons (Tableau Actions)** section.
2. Find the "Favorites" setting and toggle it on.
3. Be sure to save your changes.

## Troubleshooting

If a user reports that their favorites are not persisting between sessions, work through the following
checklist to identify the root cause.

### Pass-Through Authentication Is Active

Favorites require a persistent frontend user record. When the active authentication method is
[Pass-Through](https://docs.curator.interworks.com/setup/authentication/pass_through_authentication.md), Curator does not create or maintain
persistent user records, so there is no account to attach favorites to and the star icon's state cannot
be carried across sessions.

To resolve this, switch to any authentication method other than Pass-Through. See the
[Authentication Methods](https://docs.curator.interworks.com/setup/authentication/overview.md) overview for the available options.

### Tableau Favorites Sync Is Overwriting Curator Favorites

When a [Tableau Connection](https://docs.curator.interworks.com/creating_integrations/tableau_connection/creating_a_connection.md) is configured,
favorites synchronize in both directions between Curator and Tableau Server/Cloud. If a Dashboard is
favorited in Curator but is later un-favorited directly in Tableau Server/Cloud (or vice versa), the next
sync will reconcile the two systems and the user may perceive their Curator favorite as having been lost.

To resolve this, confirm the user's favorites in Tableau Server/Cloud match what they expect to see in
Curator. If the favorites should only be managed inside Curator, remove the Tableau Connection or have the
user manage their favorites exclusively from one side.

### SSO Username Attribute Mismatch Creates Duplicate User Records

Favorites are stored against a single frontend user record. When SSO is configured with an inconsistent
username attribute — for example, an attribute that sometimes returns the email address and sometimes
returns the user principal name — each variation creates a separate frontend user record. The favorites
saved against one record will not appear when the user is logged in under the other record, giving the
impression that favorites are not persisting.

To resolve this, verify in the Identity Provider that the attribute mapped to the Curator username claim
returns the same value for the same user on every sign-in. Then, in the Curator backend under **Users**,
look for duplicate frontend user records for the affected user and remove the extra records so that
only one persistent record remains.

### A Tableau Cloud User's Favorites Stop Syncing

On Tableau Cloud, Curator determines which site to sync a user's favorites from by reading the site portion
of each Dashboard's Tableau URL — the `/t/<site-name>/` segment. If a Dashboard's stored URL is missing that
segment — for example, if the URL was edited or pasted without it — Curator cannot resolve which site the
Dashboard belongs to, and the favorites sync for that site is skipped. The user's Tableau Cloud favorites
then stop updating, and because the sync is skipped rather than failing, no error is shown.

To resolve this, open the affected Dashboard in the Curator backend and correct its Tableau URL so that it
includes the full site path — for example, `https://your-site.online.tableau.com/t/site-name/views/...`
rather than `https://your-site.online.tableau.com/site-name/views/...`. Once every Dashboard on the site has
a valid URL, the site resolves correctly and favorites sync resumes on the next run.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.