/
Filter Share

Filter Share

image-20251222-091115.png

How to Start

You can externally share your Shared Filter with organizations outside your own. When creating an External Share, ensure that you have selected Filter as the share type.

To create an external share, please refer to Getting Started.

After creation, the Share Preview appears on the right with several tabs.

  • Preview: See how the external share contents will appear.

  • Activity: View the history. For full documentation: Activities

  • Mentions: Tag external users in comments of issues (work items) using @name, linking to the comment, with issue selection limited to items exposed by the Filter Share

  • Filter Settings: Configure columns for your custom filter.

image-20260115-142742.png

Filter Settings

Filter settings let you control how fields appear and behave in a shared filter.
You can decide which fields are visible and how external users can interact with them.

For each field, you can configure the following options:

  • Visible – Shows or hides the field in the shared filter view.

  • Searchable – Allows external users to search issues using this field.

  • Sortable – Allows external users to sort issues by this field.

These options help you tailor the shared filter to show only relevant information and keep the experience clear and secure for external users.

image-20260203-143313.png

Search behavior

Search functionality is configured directly at the field level.

  • The search box becomes available when at least one field is marked as Searchable.

  • For searchable fields, you can limit which values are available to external users.
    Only the selected values will appear in the search options, helping keep the filter focused and relevant.

This is useful when you want to:

  • Reduce the number of options external users can choose from

  • Prevent access to sensitive or irrelevant values

  • Keep search results focused and easy to use

Examples include limiting:

  • Status values to selected workflow states

  • User or label selections to an approved subset

Validation messages

If a field cannot be configured as selected, a validation message appears directly below that field.

image-20260203-143625.png

This helps you quickly understand:

  • Why a specific option is unavailable

  • What needs to be adjusted before saving the configuration

Customizable Options

On the right side of the window, you'll find various configuration options, which include:

General, Issue Fields and Permissions, Extensions, Security, Custom content, Quick Filters, Filter Configuration

Please note that the available Share Configuration settings categories may vary depending on the Share Type you select. (Issue, Board, Filter, or Timeline)

Custom content

You can customize the header and footer text.

image-20260115-135633.png

Quick Filters

image-20260115-135752.png

You can add your custom quick filters to a shared filter.

Once these quick filters are added to the shared filter, external users will see them as clickable options.

From left image, two Quick Filters are defined:

  1. Open

  • JQL: status != Done

    • In practice, clicking this filter will hide all completed issues and display only issues that are still in progress, new, or need attention.

  1. Recently Updated

  • JQL: updated >= -1d

    • This filter shows all issues that were updated within the last day.

By selecting a custom quick filters, external users can focus on the issues that meet those conditions.