Filters Activity Stream for Server: Installation Guide

Getting started

Filters Activity Stream is a dashboard gadget that shows a list of the most recently changed content in your Jira site. Compared to the standard Activity Stream, Filters Activity Stream lets you configure a basic or JQL filter. This meets many business needs, such as browsing worklog activity, or retrieving issues with specific components, sprints or versions, and much more.

Requirements

You need at least one filter that you have access to or own on your instance.
The filter must be visible to other users if the dashboard is shared.
To use a filter you did not create yourself, mark it as a favorite (star) so it appears in the gadget configuration.

Installing Filters Activity Stream

Log in to your Jira instance as an admin.
Click the admin dropdown and choose Atlassian Marketplace. The Manage add-ons screen loads.
Click Find new apps or Find new add-ons on the left-hand side of the page.
Search for Filters Activity Stream. The matching app version appears in the search results.
Click Try free to begin a trial or Buy now to purchase a license. You're prompted to log in to MyAtlassian, and Filters Activity Stream begins to download.
Enter your information and click Generate license when redirected to MyAtlassian.
Click Apply license. If you're using an older version of UPM, you can copy and paste the license into your Jira instance.

To find older versions compatible with your instance, see the version history page.

Enabling third-party cookies in your browser

To use Filters Activity Stream, third-party cookies must be enabled. Please check your browser configuration.

Microsoft Edge

Open Microsoft Edge and select Menu (the three-dot icon in the top right corner) > Settings > Site permissions > Cookies and site data.
Turn off “Block third-party cookies”.

Chrome

Open Chrome and select Menu (the three-dot icon in the top right corner) > Settings > Privacy and security > Cookies and other site data.
Turn on “Allow all cookies” or “Block third-party cookies in Incognito”.

Safari

In the Safari app on your Mac, choose Safari > Preferences, click Privacy, then:

Turn off “Prevent cross-site tracking”.
Turn off “Block all cookies”.

Safari privacy preferences with cross-site tracking prevention and cookie blocking turned off

Creating a filter

Create your custom filter. You can use a basic or JQL filter. Then save the filter.

See the Atlassian documentation on saving your search as a filter.

Jira issue search with the Save as filter option

Adding Filters Activity Stream to the dashboard

On your dashboard, you’ll see a window with “Drag your gadgets here or add a new gadget”. Click “add a new gadget”.

Jira dashboard with the add a new gadget link

Starting with the app

Customizing your filter

Add your custom filter in the filter field.

Filter field in the gadget configuration

Activity types

Optionally, you can also filter by activity type.

Display options

Limit of displayed items

You can set a limit on the number of items displayed for your search. You can still use the “Show more” button in the results later.

Refresh the activity stream automatically

To keep your content up to date without refreshing manually, select the checkbox to show a list of time periods and choose the one that suits you.

Display options with item limit and automatic refresh interval

Checking the results

The results are sorted by date.
You can open the profile of the task author.
You can go directly to the task from the result.
Depending on your search, you can:
- check the time spent on a task and the total time already spent on it;
- check the estimated time of a task;
- check comments added to a task (you can reply directly from the results);
- check created and updated issues.
Display more results with the “Show more” button.

Filters Activity Stream results listing recent worklogs, comments and issue updates

Troubleshooting

HTTP Status 400 in Google Chrome

This error can be caused by browser extensions installed in Chrome. Try disabling them.

You can also raise the default maximum header size to 64 KB in /conf/server.xml of the Jira Tomcat server:

<Connector port="8080" protocol="HTTP/1.1" maxHttpHeaderSize="65536" URIEncoding="UTF-8"/>

More information is in the Tomcat HTTP connector documentation.

Need help?

Please raise an issue in our support portal if you have questions or want to report a bug. We are here to support you.