Appearance
Presence
The Presence module lets you tell your team where you are working each half-day — at the office, from home, on holiday, or not available. Your schedule appears in the team's Presence tab and as a coloured dot on your avatar in the Members widget.
Requires admin setup
The Presence module is off by default. Your Nextcloud administrator must enable it before it appears. If you do not see Personal → TeamHub in your NC settings, ask your admin.
Where to find it
NC Settings → Personal → TeamHub
This section lets you set your own weekly schedule. It is only visible when your Nextcloud administrator has enabled the Presence module.
Your weekly template
The template is a 7 × 2 grid: one column per day (Mon – Sun), two rows per day (Morning / Afternoon). Each cell is one half-day slot.
To change a cell:
- Click any cell to open the status picker.
- Choose a status — Office, Home, Vacation, Non-working day, or any custom type your admin has defined.
- For Office or other location-based types, you can optionally pick a building → floor → room.
- Changed cells show an amber outline — your edits are a local draft, not yet saved.
To save: click Save. All 14 cells are saved at once and your calendar is updated immediately.
To discard: click Discard changes to reset all amber cells back to the last saved state.
Your template is the default for every week going forward. One-off changes go in date overrides (see below).
Status types
Your admin defines the catalogue of status types. The built-in ones are:
| Status | Busy / free | Meaning |
|---|---|---|
| Office | Free | Working from an office location |
| Home | Free | Working remotely |
| Vacation | Busy | On approved leave |
| Non-working day | Busy | Not working (e.g. day off) |
| Holiday | Busy | Admin-locked public holiday — cannot be changed |
Free statuses mean you appear available in calendar tools. Busy statuses block your time.
Date overrides
Below the template grid, a 4-month calendar shows your materialised schedule — what will actually appear in your calendar for each day.
To override a specific date:
- Click a date cell (click the top half for Morning, bottom half for Afternoon).
- Choose a status, or Clear (no entry) to remove an override.
- The override saves immediately and your calendar updates at once.
Overrides take precedence over your template for that date only.
Holiday dates
Dates marked with a diagonal stripe pattern and a lock icon are admin-locked holidays. You cannot change these. If a date should not be locked, ask your Nextcloud administrator.
How your presence appears in Nextcloud Calendar
TeamHub writes your schedule to your default Nextcloud calendar automatically:
- Free statuses (Home, Office) → calendar event marked as Free (
TRANSP:TRANSPARENT) — you appear available in scheduling tools. - Busy statuses (Vacation, Holiday, Non-working day) → calendar event marked as Busy (
TRANSP:OPAQUE) — your time is blocked. - When Morning and Afternoon have the same status → one all-day event.
- When they differ → two half-day events (00:00–12:00 and 12:00–00:00 next day).
All TeamHub presence events have a UID starting with teamhub-presence- so they are easy to identify or filter.
Members widget presence dots
On the team home, each member avatar in the Members widget has a small coloured dot showing their current half-day status. Members who are at the office or working from home are sorted to the top of the list — making it easy to see who is reachable right now.
FAQ
I cannot see Personal → TeamHub in my settings.
Your Nextcloud administrator has not yet enabled the Presence module. Ask them to go to NC Admin Settings → TeamHub → Integrations and turn it on.
I saved my template but the calendar shows old events.
Calendar sync runs when you save. If events are stale from a previous sync, they should update the next time you save any change. If they persist, ask your admin to check the Nextcloud log for [TeamHub][PresenceCalendarService] warnings.
Can I undo a date override?
Yes — click the same date cell and choose Clear (no entry). The slot reverts to your template value.
A date is locked and I cannot change it.
It is an admin-locked holiday. Contact your Nextcloud administrator to have it removed.
My presence shows in TeamHub but not in the Nextcloud Calendar app.
Make sure you have at least one calendar that is not a birthday calendar. TeamHub always writes to your default personal calendar.