# Working With the Web Portal

Everything administrators and stakeholders do in the MoodMonkey web portal: accounts and roles, employees, departments, the dashboard and settings.

_Last updated: July 9, 2026_

The web portal on [app.moodmonkey.io](https://app.moodmonkey.io) is where you manage your MoodMonkey setup and read the results: dashboards, alerts, employees, departments and settings. This guide walks through each part of the portal. Installing the desktop app is covered in the [Getting Started guide](/docs/getting-started).

## Signing In

Access to the portal works by invitation. When a colleague invites you, you receive an email that is valid for seven days.

![The MoodMonkey invitation email with the Accept Invitation button](/docs-assets/web-app/invitation-email.png)

1. Press **Accept Invitation** in the email.
2. Set and confirm your password.
3. Confirm the registration.
4. Sign in on [app.moodmonkey.io](https://app.moodmonkey.io) with your email address and password.

![The set password screen after accepting an invitation](/docs-assets/web-app/set-password.png)

## Users and Roles

Users are the people who can sign in to the web portal. There are two roles:

- **Company Administrator**: full access. Administrators manage users, employees, departments, settings, API keys and billing, and see all dashboards and alerts.
- **Company Stakeholder**: read access. Stakeholders see dashboards, employees, departments and alerts, but cannot change the setup.

People who only answer the daily check-in on their computer are **employees**, not users: they work with the desktop app and have no portal access.

![The Users page with the list of portal users and their roles](/docs-assets/web-app/users-list.png)

Administrators invite new users from the **Users** page: press **Invite user**, fill in the name, email address and role, and press **Invite**.

![The Invite user dialog with name, email and role fields](/docs-assets/web-app/invite-user.png)

## Employees

The **Employees** page shows everyone who receives the daily check-in, the feedback they submitted, and any alerts. How to add employees (and how the ID must match the Windows login name) is covered in [step 4 of the Getting Started guide](/docs/getting-started#add-employees).

![The Employees page with the feedback overview, alerts and employee list](/docs-assets/web-app/employees-overview.png)

Select an employee to see their detail page: feedback history, personal data and alerts for that one person.

![The employee detail page with feedback history and personal data](/docs-assets/web-app/employee-detail.png)

> **Tip:** An employee's own **Display timing** overrides the department and company display timing. Handy for people who work different hours than their team.

## Departments

Departments group employees by team or function, so you can compare feedback and alerts per team instead of only company-wide.

![The Departments page with per-department feedback scores and alerts](/docs-assets/web-app/departments-overview.png)

Administrators create departments with the **New department** button: pick a name, assign managers and optionally a display timing.

![The New department form with name, managers and display timing](/docs-assets/web-app/department-form.png)

> **Tip:** A department's **Display timing** overrides the company setting, and an individual employee's timing overrides both.

## Dashboard

The dashboard is the company-wide view. Every widget can switch between a weekly and a monthly time frame.

- **Feedback overview** and **Total score**: how feedback is distributed across the mood levels, and the overall score compared with the previous period.
- **Feedback completion** and **Feedback trend**: how many employees responded, and how the score develops over time.

![The feedback completion and feedback trend widgets](/docs-assets/web-app/dashboard-completion-trend.png)

- **Alerts** and **Feedback heatmap**: signals that need attention, and per-department scores over time so patterns stand out.

![The alerts widget and the feedback heatmap](/docs-assets/web-app/dashboard-alerts-heatmap.png)

- **Department feedback overview** and the **Employees** table: compare teams at a glance and search, filter or sort the full employee list.

![The department feedback overview and the employees table](/docs-assets/web-app/dashboard-departments-employees.png)

## Settings

The **Settings** page controls how MoodMonkey behaves for your company:

- **Default language**: the system language. Employees can still pick their own language in the desktop app.
- **Display timing**: when the daily check-in appears. Three options: **Automatic** (MoodMonkey learns from activity patterns and picks the best moment before the end of the workday), **Fixed time**, or **Time span** (a number of hours after the workday starts). Departments and individual employees can override this.

![The display timing options in Settings](/docs-assets/web-app/settings-display-timing.png)

- **Postpone options** and **Postpone number**: which delays employees can pick when they postpone the check-in, and how often they can postpone it.

![The postpone options in Settings](/docs-assets/web-app/settings-postpone.png)

- **Well-being alerts**: the triggers that create alerts, in two groups. Team-based triggers watch the whole team (mood drops several days in a row, low participation, a negative monthly trend, or comments containing keywords you choose). User-based triggers watch individuals (consecutive mood drops, no feedback for a number of days, keyword matches).

![The well-being alerts settings with team-based and user-based triggers](/docs-assets/web-app/settings-wellbeing-alerts.png)

- **API keys**: the keys that connect desktop app installations to your company. Creating one is [step 1 of the Getting Started guide](/docs/getting-started#create-api-key).

![The API keys section with active and expired keys](/docs-assets/web-app/settings-api-keys.png)

---

Canonical page: https://moodmonkey.io/docs/web-portal