Skip to content

Notifications

Truetask keeps you informed about things that matter — when you're assigned to a task, when someone mentions you, when a deadline is approaching. Notifications reach you three ways: in-app, browser push, and email.

The Notification Panel

Click the bell icon in the top toolbar to open the notification panel. A badge shows the count of unread notifications.

What You Get Notified About

TypeTriggered by
New AssignmentYou're assigned to a task
UnassignmentYou're removed from a task
New CommentSomeone comments on a task you're on or watching
@MentionSomeone mentions you in a description or comment
Task CompletedA task you're on is marked complete
Details UpdatedA task you're watching has its title, description, or fields edited
New AttachmentA file is attached to your task
Board InvitationYou're added to a board
OverdueA task you're on has passed its due date
UpcomingA task is due within 7 days
Due SoonA task is due within 1-2 days
Timer Auto-StoppedYour running timer was stopped after 8 hours of inactivity

Each notification has a colored icon so you can scan them quickly.

Who gets notified?

You receive notifications when you're a member of a task or a watcher.

  • Members are people explicitly assigned to the task
  • Watchers get notifications without appearing on the member list — @mentioning someone or manually clicking the watch icon adds them

See Collaboration → Watchers for more.

Filtering

Use the category tabs at the top of the panel to narrow what you see:

  • All — everything
  • Comments — comment and reply activity
  • Assignments — assignment changes
  • Mentions — @mentions only
  • Due Dates — overdue, upcoming, due soon
  • System — timer auto-stops and other app events

Actions

  • Click a notification to jump to the related task or board
  • Mark read — click the unread dot
  • Mark all read — header button
  • Dismiss — remove a single notification
  • Dismiss all — clear everything (with a confirmation)

Browser Push Notifications

Push notifications work even when Truetask isn't open. You'll get them as desktop alerts via your browser or OS.

How it works

Truetask uses VAPID — a web standard that doesn't require any third-party push service. Your notifications never leave your server; they're delivered directly from your Truetask instance to your browser.

Enable push

  1. Open Profile from the user menu (bottom of the sidebar)
  2. Go to Notifications
  3. Toggle Push Notifications on
  4. Click Allow on the browser permission prompt

Push works in Chrome, Edge, Firefox, Safari, and other modern browsers.

Disable push

From the same screen, toggle push off. If you want to revoke at the browser level, visit your browser's site settings for your Truetask URL.

Email Notifications

When your administrator has configured SMTP, Truetask can send emails for critical events:

  • Task assignments
  • @Mentions
  • Overdue reminders
  • Board invitations

Turn email on or off

Open Profile → Notifications and toggle the email option per category. Changes apply immediately.

SMTP required

If email toggles are greyed out, your administrator hasn't configured SMTP yet. Ask them to set it up in Settings → Server → SMTP.

Personal Preferences

Profile → Notifications is where you customize everything:

CategoryIn-appPushEmail
Assignments
Mentions
Due Dates
Comments
System (timers, etc.)

You can configure each row independently — get @mentions by email but assignments only in-app, for example.

Tips

  • Watching without being assigned is the best way to keep tabs on work you care about without cluttering the members list
  • Mark all read is your friend after a break — start fresh instead of scrolling through dozens of old notifications
  • If you're getting too many notifications, tighten your preferences per category rather than turning everything off
  • Push notifications are tied to the browser you enable them in — enable on multiple devices independently