# Filter albums by Tags (Tag Filter)

SharinPix albums can be filtered by tags to ensure that only relevant images are exposed to end users.

For example, you may want to display only images that have been reviewed and approved by your internal team. In that case, validated images can be assigned a specific tag (e.g., "Validated"), and the album can be configured to display only images with that tag.

To apply tag filtering on albums, you can configure the **Tag Filter** parameter in the [SharinPix Permission record](https://docs.sharinpix.com/documentation/access-and-security/sharinpix-permission-object-how-to-create-and-assign-custom-permission) assigned to the album component.

The **Tag Filter** parameter on the *SharinPix Permission* record accepts a list of tags as values, separated by semicolons. When applied to an album, only images with the specified tags are displayed. Example values can include <mark style="color:$danger;">`FireExtinguisher;FireHose`</mark>, to filter an album by images tagged with *Fire Extinguisher* and *FireHose* as demonstrated below.

### Filtering an album with the Tag Filter Example

Here is an example of an album containing images with different tags and two untagged images:

<figure><img src="https://2221230591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5EvYRrLbUyvRh8o1jmMG%2Fuploads%2FyDnB6AhmRgApCBoX9A6q%2FDOC%20SF%20-%201920%20x%20600%20(3).png?alt=media&#x26;token=f7fcd935-1d64-49c3-a442-21e352eb1a3d" alt=""><figcaption></figcaption></figure>

You can filter the available images by tag using the **Tag Filter** parameter found in the *Tag* section of the SharinPix Permission record.

<figure><img src="https://2221230591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5EvYRrLbUyvRh8o1jmMG%2Fuploads%2Flf31DxCbfP8uNBr0nELi%2F2.png?alt=media&#x26;token=759e48a1-0730-49a9-8015-3640f1ec4e7b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2221230591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5EvYRrLbUyvRh8o1jmMG%2Fuploads%2FrtRQ1cvb0HhW3kbjbLTy%2F3.png?alt=media&#x26;token=44d24c5f-6a08-413b-8681-837c4c70d59d" alt=""><figcaption></figcaption></figure>

You can also filter by **untagged images** using the checkbox **Include untagged**

<figure><img src="https://2221230591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5EvYRrLbUyvRh8o1jmMG%2Fuploads%2Frbr9ugN2lN9EpIBOnOqJ%2F4.png?alt=media&#x26;token=094cc794-c9e7-4739-9456-0eeb044f8e99" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2221230591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5EvYRrLbUyvRh8o1jmMG%2Fuploads%2FocWOV31rtdopLazfIFBu%2FDOC%20SF%20-%201920%20x%20600%20(4).png?alt=media&#x26;token=4ec6ba66-86c4-4620-bc17-1dbde4e6b193" alt=""><figcaption></figcaption></figure>
