Notifications

Notifications are the bell-icon alerts and phone push messages that keep you and your team up to date on goals, leaves, diamonds, rewards and every other thing happening in vimigo.

What is it?

Notifications are the layer that quietly carries every important event from vimigo to the right person. When Ahmad in Sales hits his monthly target, vimigo sends him a "Goal Approved" push. When Aisha in HR submits leave, her manager gets a "Leave Application" alert. When Wei in Operations is given 500 diamonds, he sees a "Diamond Received" message.

Every vimigo module - vimiGoal, vimiLeave, vimiBank, vimiChallenge, vimiRewards, vimiCheckin, Diamond, EWF, Leaderboard, Badge, vimiKnowledge, vimiSales, vimiTeam, vimiReview and more - sends its alerts through this same system. You get two things in one place: the push notification that lights up your phone, and the inbox that keeps a record for later.

You rarely have to set up notifications directly. They come on automatically as soon as the module that produces them is enabled for your company. What you do choose is which ones you want to receive, and when.

Quick Start

If you're brand new to vimigo, do these in order to make sure your notifications are working:

1. Log in to the vimigo mobile app at least once. This registers your phone so pushes can be delivered.
2. Tap the "Bell" icon in the app. This is your "Inbox" - it stores every notification for you.
3. Go to "Profile" > "Notification Settings" and scroll through the list of notification types. Each one has an "On" / "Off" toggle.
4. Turn off anything you don't care about (for example, "Daily Quote" if you find it noisy). Leave the rest on.
5. If you're an admin, log into the web admin panel and click "Notifications" in the left sidebar to see the same inbox with a bigger view.

After this, you'll receive a phone push every time something important happens to you, and you'll always be able to scroll back through the inbox to find it.

For Admins (Employer / HR / Manager)

How to change the default notifications for the whole company

Use this when new employees keep getting a type of notification you don't want them to get by default, or when nobody is getting a notification you want everyone to have on.

1. In the admin panel, open "System" > "Notification Configurations" in the left sidebar.
2. The page title shows "Notification Configurations" with an "Edit:" heading.
3. You'll see one row per notification type - for example "Goal Approved", "Leave Rejected", "Today's Birthday", "Diamond Received".
4. For each type, pick "Yes" (enabled by default) or "No" (disabled by default) from the dropdown.
5. Click "Update" at the bottom to save everything at once.

Important: Changing a default only affects employees who have never touched that specific toggle. If Ahmad already switched off "Daily Quote" himself, changing the default back to "Yes" will not turn it back on for him. This protects personal preferences.

How to send a custom push notification to specific employees

Use this for one-off messages - for example, "Team meeting moved to 3pm tomorrow" - that don't fit any existing module event.

1. Make sure your admin account has the "Send Notification to Employee" permission. Ask whoever manages access rights if you're not sure.
2. Open the Boss App (admin mobile app) or use the web admin panel's custom notification form.
3. Fill in:
   • "title" - the notification headline (e.g. "Meeting moved").
   • "message" - the body text (e.g. "Team meeting tomorrow is now at 3pm, Level 5 meeting room.").
   • "user_ids" - the employees you want to notify. You can pick one, a department, or multiple people.
4. Submit. The push goes out immediately.

Tip: Short titles work best on mobile lock screens. Keep them under 50 characters.

How to review the admin notification inbox

1. In the admin panel, click "Notifications" in the left sidebar. The page header reads "Notifications".
2. Newest notifications appear first. Unread ones show an orange filled circle; read ones show an open circle.
3. Each row shows the message text and a relative timestamp - "5 minutes ago", "Yesterday at 2:30 pm", or "Apr 15 at 9:00 am" for older items.
4. Click any notification to open it (this marks it read automatically).
5. To clear all unread at once, click "Mark all as Read" at the top right of the list.
6. The bottom of the page shows pagination and a total count like "38 Notifications".

How to diagnose "I'm not getting any notifications!"

Work through these checks in order - in practice, 90 percent of missing-notification reports come from items 1 and 2.

1. Has the employee logged in to the mobile app at least once? Device tokens are only registered when the user logs in. If they reinstalled the app or cleared app data, ask them to log in again.
2. Has the employee disabled that notification type? Have them check "Profile" > "Notification Settings" on their phone.
3. Is the company default set to "No"? Open "System" > "Notification Configurations" and check the dropdown. If it's "No", that's why new hires don't get it - they inherit the company default.
4. Is the module enabled for the company? If your company doesn't use vimiChallenge, nobody will get challenge notifications regardless of preferences.
5. Was it a burst of alerts? vimigo caps delivery at 83 notifications per user per minute. If someone ran a big bulk action, a few messages may have been rate-limited.

For Employees

How to view your notification inbox

1. Open the vimigo app on your phone.
2. Tap the "Bell" icon in the top or bottom navigation bar.
3. Your "Inbox" opens with the most recent messages first.
4. Unread notifications show an orange filled circle indicator on the left. Read ones show an open circle.
5. Tap any row to open it. Once opened, it's marked as read automatically.

How to manage which notifications you receive

1. In the app, go to "Profile" > "Notification Settings".
2. You'll see notification types grouped by module (vimiGoal, vimiLeave, vimiBank, Social, and so on).
3. Each type has an "On" / "Off" toggle:
   • "On" - you get a phone push and an inbox entry when this event happens.
   • "Off" - you get neither.
4. Toggle anything off that you find noisy. Common ones people switch off: "Daily Quote", "Today's Birthday", "Leaderboard Rankings".
5. Changes take effect immediately - no save button, no restart needed.

Tip: If you want to keep receiving a notification in the inbox but stop the phone buzz, use your phone's system-level notification settings for the vimigo app (Android: "Settings" > "Apps" > "vimigo"; iOS: "Settings" > "Notifications" > "vimigo"). This silences pushes without changing your in-app preferences.

What notifications you can expect

You'll see notifications based on three things:

• Your company's enabled modules. If your company doesn't use vimiChallenge, you won't get challenge alerts.
• Your role. Goal notifications go to the goal owner and their manager. Leave notifications go to the applicant and the approving manager.
• Your personal preferences. Anything you've switched off in "Notification Settings" is suppressed.

Settings & Configuration

Setting	What it does	Default	Where
"Yes / No" per notification type	Company-wide default for that type	Varies per type	Admin panel > "System" > "Notification Configurations"
"On / Off" per notification type	Individual user override	Matches company default	vimigo app > "Profile" > "Notification Settings"
"Send Notification to Employee" permission	Who can send custom pushes	Admin only	Admin panel > Access Rights
"Mark all as Read"	Clears all unread badges	-	Admin panel > "Notifications" (top right link)
Device token registration	Enables push delivery	Automatic on login	Happens silently when user opens the app

FAQ

Q: Why am I getting the same notification twice?

A: This was a known issue before March 2026 where some preferences could be stored twice for one user. The platform has since added a safeguard that prevents it. If you still see duplicates, ask your admin to check whether two separate scheduled jobs are firing the same event (for example, two birthday reminders on the same day).

Q: Why does the app inbox not show the announcement I just sent?

A: Announcements are handled slightly differently and appear in the dedicated "Announcement" area rather than the main notification inbox. See the Announcements guide for where to find them.

Q: Can employees turn off notifications I really want them to see?

A: Most types yes, but your system admin can mark specific types as "always on" so the toggle doesn't appear in the user's preferences screen. Use this sparingly - people who feel spammed by vimigo tend to disable the app at the operating-system level, which is worse.

Q: My new hire isn't getting any notifications. What do I check first?

A: Confirm they've logged into the mobile app at least once. Device tokens are only registered on login. If they only ever use the web dashboard, they'll see the inbox but no phone push will arrive.

Q: Does vimigo send email notifications?

A: Some types do, yes - this is configured per notification type. The majority of alerts go through phone push and the in-app inbox. If you want a specific type emailed as well, raise it with support.

Q: Someone left the company. Will they stop getting notifications?

A: Once they're deactivated as an employee, the system stops sending to them. Their device token stays registered until they log out or reinstall the app, but no new events target them.

Q: Why do I get notifications on my Boss App but not my employee app (or vice versa)?

A: Each notification type is configured to go to either the employee app ("vimigoapp"), the admin app ("vimiboss"), or both. Approval requests typically go to the Boss App. If you think a type should go to both and isn't, ask your admin to update the channel setting.

Q: How do I clear all the notifications at once?

A: In the admin panel, click "Mark all as Read" at the top right of the "Notifications" page. On mobile, most employees just scroll through the bell inbox - there's an in-app "Clear All" option on some versions of the app.

Q: Can I get notifications by WhatsApp or SMS?

A: Not directly. vimigo sends push notifications to the app and (for some types) email. If your team lives on WhatsApp, the best workflow is to have the person actionable (for example, the approving manager) keep the app installed.

Related Guides

• Announcements - the other way to push a message to everyone, for company-wide news.
• Mobile Basics - logging in, which also registers your device for push notifications.
• vimiLeave - the leave approval notifications everyone asks about first.
• vimiGoal - the goal approval, rejection and achievement notifications.
• Diamond - the "Diamond Received" alert that shows up when someone awards you diamonds.
• Users - Notification preferences are per user.