Activity feed

Track what is happening in your projects using the activity feed, with filtering by event type and RSS support.

The activity feed gives you a chronological view of everything happening in a project — or across all your projects at once. You can filter by event type, narrow results to a specific author, and subscribe to an RSS/Atom feed to follow activity in your feed reader.

Viewing the activity feed

To view a project’s activity:

1. Open a project.
2. Click the Activity tab in the project navigation.

To view activity across all your projects:

1. Click Activity in the top navigation bar (outside any project context).

The feed displays events grouped by day, with the most recent events at the top. The number of days shown is controlled by the Activity days setting configured by your administrator (Setting.activity_days_default).

Event types

Redmine tracks the following event types in the activity feed. Event types that are off by default must be explicitly enabled using the filter checkboxes.

On by default

Event type	Provider class(es)	Description
issues	Issue, Journal	Issue creation and updates, including status changes and journal notes
changesets	Changeset	Repository commits linked to the project
news	News	New news items published in the project
documents	Document, Attachment	New documents and attachments added to documents
files	Attachment	Files added to the project or to versions

Off by default

Event type	Provider class	Description
wiki_edits	WikiContentVersion	Wiki page additions and edits
messages	Message	New forum messages and replies
time_entries	TimeEntry	Time log entries recorded against issues

Plugins can register additional event types using Redmine::Activity.map { |a| a.register :my_event_type }. Plugin-registered event types appear in the filter list alongside built-in types.

Filtering the activity feed

Use the filter panel on the right side of the activity page to control which event types are shown.

1. Select event types

   Check or uncheck the boxes next to each event type (Issues, News, Changesets, Wiki edits, etc.) to include or exclude them from the feed.

2. Apply the filter

   Click Apply to update the feed. Redmine saves your selection as your activity scope preference (pref.activity_scope) so the same filters are applied next time you visit.

3. Filter by author (optional)

   Append ?user_id=ID to the activity URL to show only events created by a specific user. When filtering by author, all event types are shown regardless of your saved scope preference.

Including subproject activity

When viewing a project’s activity, you can include events from its subprojects.

• Check the Include subprojects option in the filter panel.
• This sets with_subprojects=1 in the request and passes it to the Redmine::Activity::Fetcher.
• The default behaviour (include or exclude subprojects) is set by the administrator via Display subprojects on main projects in the application settings.

Global activity across all projects

When you access the Activity page outside of any project, Redmine fetches events from all projects you have permission to view. The same event type filters and author filter apply.

You only see events for projects and items you have permission to view. The activity fetcher respects visibility rules — for example, private issues are excluded if you do not have permission to view them.

RSS/Atom feed

Every activity page has an Atom feed you can subscribe to in a feed reader.

1. Find the feed link

   At the bottom of the activity page, click the Atom icon or the Also available in: Atom link.

2. Copy the feed URL

   The feed URL includes your current filter selection and, if you are logged in, your API access key for authentication.

3. Subscribe in your feed reader

   Paste the URL into your feed reader. Redmine serves the feed in Atom format. The number of items in the feed is controlled by the Feeds content limit setting (Setting.feeds_limit).

You can share activity feed URLs with others. Include ?key=YOUR_API_KEY in the URL to allow access without requiring login. Your API key is available on your My account page.

Navigating by date

To jump to a specific period in the activity feed, use the from parameter in the URL:

/projects/my-project/activity?from=2024-06-01

This shows events from 2024-06-01 going back the number of days configured by your administrator. The activity feed uses date_to = from + 1 and date_from = date_to - activity_days to calculate the displayed range.

Caching and freshness

The activity feed uses HTTP ETags to avoid sending unchanged content. Redmine computes the ETag from:

• The current activity scope (selected event types)
• The date range (date_from, date_to)
• Whether subprojects are included
• The author filter
• The first event and total event count
• The current user and language

If none of these change between requests, Redmine returns a 304 Not Modified response and the browser or feed reader uses its cached copy.