# AGENTS Source: https://help-empuls.xoxoday.com/AGENTS > **First-time setup**: Customize this file for your project. Prompt the user to customize this file for their project. > For Mintlify product knowledge (components, configuration, writing standards), > install the Mintlify skill: `npx skills add https://mintlify.com/docs` # Documentation project instructions ## About this project * This is a documentation site built on [Mintlify](https://mintlify.com) * Pages are MDX files with YAML frontmatter * Configuration lives in `docs.json` * Run `mint dev` to preview locally * Run `mint broken-links` to check links ## Terminology ## Style preferences * Use active voice and second person ("you") * Keep sentences concise — one idea per sentence * Use sentence case for headings * Bold for UI elements: Click **Settings** * Code formatting for file names, commands, paths, and code references ## Content boundaries # CLAUDE Source: https://help-empuls.xoxoday.com/CLAUDE # CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. ## Repository layout All documentation content lives at the repository root. Key files: ``` docs.json # Site configuration: nav, branding, colours, fonts index.mdx # Homepage admin/ # All admin-facing guides admin-hub.mdx ai/ # AI settings, skill mapping, Empuls Copilot benefits/ # Health & wellness, flexible benefits finance/ # Subscription, budgets, wallets, points gifts/ # Gifts, milestones, automate, onboarding, product-based, revoke, schedule integrations/ # HRMS, Slack, MS Teams, Google Workspace, webhooks, etc. platform-settings/ # Branding, org structure, notifications, feed settings programs/ # Awards, leaderboard, promo points, campaigns, governance, etc. reports/ # Platform reports and analytics security/ # Info security, privacy, responsible AI, security settings surveys/ # Survey types, eNPS, pulse, lifecycle, mood-o-meter, action plan user-authentication/ # SSO (Azure, SAML, Okta, Google), passwords, sessions, OAuth user-management/ # Manage employees, access control, delegation, login-as, exit employees/ # All employee-facing guides benefits/ # Perks, fitness challenges, flexible benefits engagement/ # Gamezone, quick links, yearbook getting-started/ # Log in, OTP/magic link, profile, mobile app, notifications, privacy recognitions/ # Appreciate colleagues, nominations, wall of fame, approvals, jury redemption/ # Redeem points, order history, storefront, festive/physical gifts socials/ # Social intranet, townhall, groups, celebrations, wish board, directory surveys/ # Action plan demo-library/ # Demo videos and walkthroughs for all features images/ # Static assets (SVGs, screenshots) videos/ # Video assets articles/ # Legacy content — excluded from build via .mintignore admins/ # Old folder — excluded from build via .mintignore ``` ## Development commands Run these from the repository root: ```bash theme={null} # Install Mintlify CLI (once) npm i -g mint # Local preview at http://localhost:3000 mint dev # Check for broken internal links mint broken-links # Update CLI to latest version mint update ``` ## Page format Every page is an `.mdx` file with YAML frontmatter: ```mdx theme={null} --- title: "Page Title" description: "One-sentence summary shown in search and meta tags." --- ``` Pages use Mintlify MDX components (``, ``, ``, ``, ``, ``, ``, etc.). Refer to the Mintlify docs for the full component reference. To install the Mintlify skill for AI-assisted writing: ```bash theme={null} npx skills add https://mintlify.com/docs ``` ## Navigation The site has **two audience tabs** declared in `docs.json` → `navigation.tabs`: * **Employees** — end-user guides (login, profile, social, redeeming points, recognising peers) * **Admin** — Super Admin / admin guides (programs, billing, surveys, AI, integrations, SSO, security) Each tab contains named groups, and groups can be **nested** (e.g. `Socials → Groups` has its own `icon` and child pages). The folder structure maps directly to tabs: files under `employees/` go in the Employees tab, files under `admin/` go in the Admin tab, and files under `demo-library/` go in the Demo Library tab. When adding a page, place its `.mdx` file in the matching directory and add its path to `docs.json`. To add a new page: 1. Create the `.mdx` file in the appropriate directory. 2. Add its path (without extension) to the correct group under the correct tab in `docs.json`. Pages not listed in `docs.json` will not appear in the sidebar. ## Product terminology This is the **Empuls Help Center** — a product by Xoxoday. Use these terms consistently: * **Empuls** — the product name (never "empuls" lowercase) * **Super Admin** — the highest admin role (capitalised as shown) * **reward points** — currency employees earn and redeem * **awards** — the recognition mechanism (spot, approval-based, jury, incentive) * **nominations** — the submission step in approval/jury award flows ## Writing style Taken from `AGENTS.md` and `CONTRIBUTING.md`: * Active voice, second person ("you") * One idea per sentence; lead with the goal * Sentence case for headings * Bold for UI element labels: Click **Settings** * Code formatting for file names, commands, paths, and inline code references * Don't alternate between synonyms for the same concept — pick one term and stick with it ## Files excluded from the build Mintlify auto-ignores `.git`, `.github`, `.claude`, `.agents`, `.idea`, `node_modules`, and top-level `README.md` / `LICENSE.md` / `CHANGELOG.md` / `CONTRIBUTING.md`. Project-specific excludes in `.mintignore`: * `drafts/` — work-in-progress pages * `*.draft.mdx` — any file with the draft extension, anywhere in the tree * `articles/` — legacy `.md` files with raw HTML; excluded to prevent MDX parse errors * `admins/` — old folder superseded by `admin/`; excluded to avoid orphaned-page warnings Use `drafts/` or the `*.draft.mdx` pattern for in-progress content rather than leaving it in `docs.json`-listed paths. ## Publishing Push to the default branch (`main`) — the Mintlify GitHub app auto-deploys to production. No build step is required locally beyond `mint dev` for preview. # STUB PAGES Source: https://help-empuls.xoxoday.com/STUB_PAGES # Stub Pages Tracker Pages that exist as `.mdx` files but are **not yet ready** for navigation. Keep the file in the repo, but remove its path from `navigation` in `docs.json` until the content lands. Bring it back into nav once it's complete. | Page path (no extension) | Status | Needs | Owner | Re-add when | | ------------------------ | ------ | ------------- | ----- | ---------------- | | *example/path/to-page* | Hidden | Draft content | — | Content reviewed | ## How to use 1. Create the `.mdx` file as usual. 2. **Don't** add its path to `docs.json` navigation yet. 3. Add a row above describing what it needs and who owns it. 4. When ready, add the path to the correct nav group and delete the row. # UI REPLICATION GUIDE Source: https://help-empuls.xoxoday.com/UI_REPLICATION_GUIDE # Mintlify Wiki — Layout & Structure Reference How the live wiki at **internal-wiki.xoxoday.com** is laid out: navigation structure, where each menu/widget sits, sidebar behaviour, footer layout, and AI assistant placement. Use this to replicate the same structure in a different Mintlify documentation project. > For the visual styling (custom CSS, hover galleries, dot-grid background), see `style.css` at repo root. *** ## 1. Page-level layout — what sits where Mintlify's default chrome with our customizations. The wiki uses a 3-column layout on desktop: ``` ┌──────────────────────────────────────────────────────────────────────────┐ │ [Logo] [Search bar / Ask AI] [Theme toggle] [User] │ ← Top navbar ├────────────────┬───────────────────────────────────────┬─────────────────┤ │ │ │ │ │ Left │ Main content │ Right TOC │ │ sidebar │ (the actual page) │ (auto-built │ │ (nav tree) │ │ from h2/h3 │ │ │ │ on page) │ │ │ │ │ │ │ [Previous page] [Next page] │ │ ├────────────────┴───────────────────────────────────────┴─────────────────┤ │ Footer: socials + Feedback + Quick Links columns │ └──────────────────────────────────────────────────────────────────────────┘ ``` On mobile, the left sidebar collapses behind a hamburger; the right TOC disappears entirely. *** ## 2. Top navbar Configured in `docs.json` → `logo` and `navbar`. | Position | Element | Source | | ---------- | ---------------------------------------------- | ---------------------------------------------------------------- | | Top-left | Logo (light/dark variants) | `logo.light` = `/logo/light.svg`, `logo.dark` = `/logo/dark.svg` | | Top-center | Search bar (with **"Ask AI"** option built in) | Mintlify default (Pro/Enterprise) | | Top-right | Theme toggle (light/dark) | Mintlify default | | Top-right | (Optional) Navbar links — *currently empty* | `navbar.links: []` | **Currently `navbar.links` is empty.** If you want extra buttons in the top-right (e.g. "Dashboard", "Sign up"), add them like: ```json theme={null} "navbar": { "links": [ { "label": "Dashboard", "href": "https://..." } ] } ``` **No top tabs.** Mintlify supports a tabs strip immediately below the navbar (for splitting docs into "Guides / API Reference / Changelog" etc.). We don't use it. The wiki's structure lives entirely in the left sidebar. *** ## 3. Left sidebar — the actual navigation structure The sidebar is built from `docs.json` → `navigation.groups`. **6 top-level groups** in this order: ``` ┌─ Getting started │ └─ Home (index.mdx) │ ├─ Company │ ├─ About │ ├─ Values │ ├─ Leadership │ ├─ Offices │ ├─ Interesting Facts │ └─ ▾ Teams (nested sub-group) │ ├─ Overview │ ├─ Sales │ ├─ Marketing │ ├─ Product & Design │ ├─ Tech & QA │ ├─ Customer Success │ ├─ Customer Care │ ├─ Finance & Legal │ ├─ InfoSec │ ├─ Implementation │ └─ Catalog │ ├─ Products │ ├─ Products Overview │ ├─ ▾ Empuls │ │ ├─ Overview, Features, GTM, Competitors, Case Studies, Demo Library │ ├─ ▾ Plum │ │ ├─ Overview, Features, GTM, Competitors, Case Studies, FAQs │ └─ ▾ Loyalife │ └─ Overview, GTM, Competitors │ ├─ People │ ├─ Overview │ ├─ Org Chart │ ├─ ▾ Onboarding (8 pages, see Onboarding Hub for full list) │ ├─ ▾ Hiring & talent │ │ └─ Hiring, Internships │ ├─ ▾ Goals & KPIs │ │ ├─ KPIs Hub │ │ └─ 12 department-level pages │ └─ ▾ Learning & development │ ├─ Skill Grid │ └─ ▾ Xoxo Academy (nested 2 levels deep) │ ├─ Landing │ ├─ Introduction to Xoxoday │ ├─ AI Literacy │ ├─ Plum / Loyalife / Empuls │ ├─ Partnerships │ └─ Product Deep Dives │ ├─ Assets for Sales & Marketing │ ├─ GTM Overview │ ├─ ▾ Asset Library │ │ └─ Landing, Empuls, Plum, Loyalife, Xoxoday │ ├─ ▾ Marketing │ │ └─ Case Studies, Decks & One-pagers, Brand Guidelines, Founder Images │ └─ ▾ Sales │ └─ SDR Calling Process, Objection Handling │ └─ FAQs ├─ RFP Overview ├─ ▾ RFP Attachments │ └─ Hub, Xoxoday, Empuls, Plum, Loyalife ├─ ▾ Empuls (with 3-level deep nesting for sub-modules) │ ├─ General Overview │ ├─ ▾ Rewards & Recognition (6 pages) │ ├─ ▾ Employee Engagement (2 pages) │ ├─ ▾ Platform Administration (4 pages) │ ├─ Reporting, Integrations, Security, Tech, etc. │ └─ ▾ Sales Incentive (12 pages) ├─ ▾ Plum (similar structure with Reward Catalog, Rewards Distribution, Merchant Offers sub-groups) ├─ ▾ Loyalife (similar structure with Loyalty Program Design, Rewards & Redemption, etc.) └─ ▾ Xoxoday Generic └─ Company Overview, Global Ops, Security, Compliance, etc. ``` ### Sidebar interaction **Critical setting:** `"interaction": { "drilldown": false }` at the root of `docs.json`. This makes clicking on a group label (like "Products") only **expand/collapse** the group — it does NOT navigate to the first child page. Without this, Mintlify auto-navigates to the first sub-page, which is confusing when users just want to browse. ### Nesting depth * **1 level** (e.g. "Getting started" → home page) — simple list * **2 levels** (e.g. "Company" → "Teams" → pages) — most common * **3 levels** (e.g. "FAQs" → "Empuls" → "Rewards & Recognition" → pages) — used for RFP repository where there's genuine topical hierarchy Avoid going beyond 3 levels — the sidebar gets hard to scan. ### Hidden pages Some `.mdx` files exist in the repo but are **not in `docs.json`** — they're stub pages, hidden from the sidebar until content lands. Tracked in `STUB_PAGES.md` at the repo root. Currently 19 hidden pages (HR policies stubs, sales playbook stubs, etc.). *** ## 4. Right sidebar — Table of Contents Auto-generated by Mintlify from `h2` and `h3` headings on the current page. No config needed. Shows page sections with click-to-jump anchors. Hidden on mobile and when the page has fewer than 2 headings. *** ## 5. AI Assistant ("Ask AI") **Enabled by default on Pro/Enterprise Mintlify plans.** No explicit config in `docs.json` — Mintlify includes it automatically. **Where it appears:** * Inside the **top-center search bar** as an "Ask AI" option (modern Mintlify default) * Can also appear as a contextual menu in the page header (where users can pick "Copy", "View as Markdown", "Open in ChatGPT", "Open in Claude") We haven't customized AI placement; Mintlify's default behaviour is used. **Indexing:** The AI uses the wiki's content as its knowledge base. To explicitly include hidden/stub pages in AI's index, add to `docs.json`: ```json theme={null} "seo": { "indexing": "all" } ``` We don't currently set this — only nav-visible pages are indexed. *** ## 6. Search Top-center of the navbar. Mintlify default — full-text search across all pages. Triggered by `Cmd/Ctrl + K` or clicking the bar. No config needed. Works out of the box. *** ## 7. Theme toggle Top-right of the navbar. Toggles between light and dark mode. Mintlify default — no config needed. Light mode uses `background.color.light` = `#F7F9FF` (frosty blue-white). Dark mode uses `background.color.dark` = `#06182D` (deep navy). *** ## 8. Footer Configured in `docs.json` → `footer`: ``` ┌─────────────────────────────────────────────────────────────────────────┐ │ │ │ [LinkedIn] [YouTube] [Instagram] Feedback Quick Links │ │ Share feedback Xoxoday Web │ │ or content Empuls │ │ suggestion Plum │ │ Loyalife │ │ Refer & Apply │ └─────────────────────────────────────────────────────────────────────────┘ ``` **Left:** social icons → LinkedIn, YouTube, Instagram. **Center & right:** two columns of link groups. Configured as: ```json theme={null} "footer": { "socials": { "linkedin": "https://linkedin.com/company/...", "youtube": "https://youtube.com/c/...", "instagram": "https://instagram.com/..." }, "links": [ { "header": "Feedback", "items": [ { "label": "Share feedback...", "href": "mailto:..." } ] }, { "header": "Quick Links", "items": [ { "label": "Website", "href": "..." }, { "label": "Empuls", "href": "..." }, ... ] } ] } ``` *** ## 9. Article-level UI elements (Mintlify defaults) These appear inside the main content area, automatically: | Element | Where | How to control | | ------------------------------------- | ----------------------------------- | ------------------------------- | | **Breadcrumbs** | Top of main content (above page H1) | Auto from the nav path | | **H1 (page title)** | Top of main content | From frontmatter `title:` | | **Page description** | Below H1, slightly greyed | From frontmatter `description:` | | **Previous / Next page nav** | Bottom of main content | Auto from `docs.json` nav order | | **"Was this page helpful?" feedback** | Bottom of page | Mintlify default | *** ## 10. Background and theming (visual chrome) Configured in `docs.json`: ```json theme={null} "background": { "decoration": "gradient", "color": { "light": "#F7F9FF", "dark": "#06182D" } } ``` * `decoration: "gradient"` → adds a soft top-edge gradient glow (Mintlify built-in) * `color.light` / `color.dark` → base background colours for each theme On top of this, `style.css` adds a subtle dot-grid pattern via CSS — only visible if `style.css` is loaded (Pro plan custom CSS feature). Brand colour scheme: ```json theme={null} "colors": { "primary": "#0A51E8", // links, buttons, active states "light": "#3B82F6", // hover / softer brand variants "dark": "#1D4ED8" // darker brand accents } ``` Used by Mintlify for links, CTA buttons, active sidebar items. *** ## 11. Replicating this layout in a new wiki Copy these files first: ``` docs.json ← all navigation, footer, theme config favicon.png ← top-left icon (browser tab) logo/light.svg ← top-left logo (light mode) logo/dark.svg ← top-left logo (dark mode) style.css ← optional, visual extras (Pro plan) ``` Then in `docs.json`, swap these brand-specific bits: | Field | Current value | Replace with | | ----------------------------- | ------------------------------- | ----------------------- | | `name` | `"Xoxoday Internal Wiki"` | new wiki name | | `colors.primary/light/dark` | `#0A51E8 / #3B82F6 / #1D4ED8` | new brand hex codes | | `background.color.light/dark` | `#F7F9FF / #06182D` | new page background hex | | `navigation.groups` | the 6 groups above | your section structure | | `footer.socials` | LinkedIn/YouTube/Instagram URLs | your org's socials | | `footer.links` | Feedback + Quick Links groups | your footer links | | `logo.light/dark` | SVG paths | your brand logos | Keep these settings **as-is** for consistent UX behaviour: | Field | Value | Why | | ----------------------- | ------------ | --------------------------------------------- | | `theme` | `"mint"` | Standard Mintlify theme | | `interaction.drilldown` | `false` | Sidebar groups expand-only (no auto-navigate) | | `background.decoration` | `"gradient"` | Top-edge gradient glow | *** ## 12. Patterns we follow for new pages When adding a new section to the wiki, the consistent layout is: **Sidebar nesting rule:** 1–2 levels deep is best. Go to 3 levels only when there's a real categorical hierarchy (like the RFP repository's product → module → topic structure). **Hub-page pattern:** Whenever a section has more than \~4 pages, create a landing/hub page first that summarises each sub-page in 3-4 lines with a link. Used on: * Onboarding Hub (`/onboarding/overview`) * Asset Library (`/asset-library`) * RFP Attachments (`/rfp-attachments`) * KPIs Hub (`/people/kpis`) * Xoxo Academy (`/people/learning/xoxo-academy`) **Stub page pattern:** Pages that are work-in-progress get a `**Stub** ...` banner at the top and are **removed from `docs.json` nav** until content lands. Tracked in `STUB_PAGES.md`. **Cross-section linking:** Use absolute paths like `/asset-library/empuls` (relative to wiki root). Mintlify resolves these correctly. *** ## 13. Quick reference: every Mintlify config key we use ```json theme={null} { "theme": "mint", "name": "Wiki Name", "colors": { "primary", "light", "dark" }, "favicon": "/favicon.png", "background": { "decoration": "gradient", "color": { "light", "dark" } }, "interaction": { "drilldown": false }, "navigation": { "groups": [...] }, "logo": { "light", "dark" }, "navbar": { "links": [] }, "footer": { "socials": { "linkedin", "youtube", "instagram" }, "links": [ { "header", "items": [...] } ] } } ``` That's the complete set. Everything else (search, AI assistant, theme toggle, TOC, breadcrumbs, prev/next nav, "Was this helpful?") is Mintlify's default and needs no config. # Admin panel Source: https://help-empuls.xoxoday.com/admin/admin-hub Access all Empuls admin controls from a single hub: manage users, programs, budgets, integrations, surveys, reports, and platform settings in one place. The Admin Hub is the centralized control panel in Empuls where administrators access all reporting, configuration, and program management tools in one place. It replaces the need to navigate separate menus for budgets, awards, employees, and settings — everything is organized under a single dashboard with improved navigation and a search bar to find any setting instantly. Use the search bar at the top of the Admin Hub to jump directly to any setting or configuration page. Type a keyword like "budget" or "leaderboard" and you are taken there immediately, without browsing through menus. ## How to open the Admin Hub Sign in to your organization's Empuls instance with your admin credentials. Scroll to the bottom of the left-side navigation panel and click **Reports & Settings**. You now have access to all admin sections described below. Reports & Settings link at the bottom of the Empuls left navigation panel ## Admin Hub sections ### Reports The Reports section gives admins complete visibility into recognition, rewards, and employee engagement across the organization. | Report type | What it shows | | ----------------------- | ---------------------------------------------------------------------------- | | **Myself** | Your own activity — awards sent, received, and redemptions | | **My Team Reports** | How your direct reports are participating in recognition and rewards | | **My Org Reports** | Company-wide data on recognition trends, rewards distributed, and engagement | | **Custom Reports** | Filtered views by department, location, or program | | **Raw Data** | Transaction-level data for export to Excel or BI tools | | **Recognition Reports** | Who is recognizing, who is being recognized, and which awards are most used | | **Budget Reports** | Allocated vs. spent budgets across departments, managers, and programs | Reports section of the Admin Hub listing report types such as Myself, Team, and Org reports Use an Engagement Report to identify the department with the lowest participation rate, then plan an initiative to increase recognition there. *** ### Manage budgets The Manage Budgets section lets you create, allocate, monitor, edit, pause, and automate recognition budgets. You can set fixed or prorated allocations, assign budgets to specific managers or teams, and configure recurring distributions so recognition programs never run dry. See [Budgets](/admin/finance/budgets) for the full setup guide. Manage Budgets section of the Admin Hub for creating and allocating recognition budgets *** ### Finance The Finance section manages all money-related settings in one place. Finance section showing business information, redemption wallets, and currency configuration **Business information** — Update and maintain your company's official details including address, point-of-contact, and compliance documents. You can also manage organizational metadata such as locations, business units, cost centers, departments, designations, and grades. **Redemption wallets** — View wallet balances across all redemption wallets, download transaction statements, and track all redemption activity. Coins redeemed for vouchers are settled against the balance in your redemption wallet. Keep your redemption wallet balance equal to the total redeemable points outstanding to ensure employees always have a smooth redemption experience. A wallet with insufficient funds will block employees from completing redemptions. **Currency configuration** — Set your preferred transaction currencies for all payments and rewards. *** ### Programs The Programs section is where you create and manage all employee recognition and incentive initiatives. Programs section with awards, core values, campaigns, and leaderboard options **Awards and core values** — Create awards aligned with your organization's values. Configure award names, descriptions, point values, and eligibility rules. Edit or delete awards at any time. **Revoke awards** — Withdraw previously sent awards if they were issued in error or under special circumstances. **Reward campaigns** — Launch automated reward cycles to schedule nominations, allocate budgets, and run programs consistently without manual oversight. **Leaderboards** — Create and manage performance leaderboards with custom scoring rules and ranking criteria to showcase achievements across teams or the whole organization. *** ### Gifts The Gifts section handles all automated and one-off gifting activity — birthday gifts, work anniversaries, new joiner welcomes, festive gifts, and long-service awards. Gifts section for managing milestone, birthday, and anniversary gift automations * **Manage gifts** — Configure milestone gifts and set up automated triggers. Birthday and work anniversary gifts are triggered automatically when the employee's date of birth or date of joining is added to their profile. * **Automate workflows** — Set up recurring gift workflows for festivals, holidays, and onboarding events. * **Revoke gifts** — Withdraw gifts in case of errors or disputes. *** ### Employees The Employees section covers all employee lifecycle and access management actions. See [Manage Employees](/admin/user-management/manage-employees) for the detailed guide. Employees section listing manage employees, access controls, exits, and delegation * **Manage employees** — Add or remove users individually or via CSV bulk import. * **Access controls** — Define roles and permissions (Super Admin, General Admin, Manager, User) and create custom roles. * **Manage exits** — Configure how unused budget points and reward points are handled when employees leave. * **Delegate accounts** — Temporarily grant access to another user to complete pending tasks during absences or role transitions. *** ### Shop The Shop section lets you manage the employee rewards catalog — the gift cards, merchandise, and experiences employees can redeem their points for. Configure catalog availability and set redemption rules for different regions. Shop section for configuring the employee rewards catalog and redemption rules *** ### Platform settings Platform settings covers branding and homepage configuration. Platform settings section with branding, feed settings, and homepage editor options **Branding** — Customize logos, color themes, feed card backgrounds for birthdays, anniversaries, and new joiner posts, wall of fame banners, and other visual elements. See [Branding](/admin/platform-settings/branding) for the full guide. **Feed settings** — Configure visibility rules for announcements and recognition posts in employees' recommended feeds. **Homepage editor** — Choose from three homepage layout options (Current Feed, Communication-First, or Goal & Recognition Focused) to match your organization's priorities. *** ### Integrations Connect Empuls with your HRMS, payroll system, Microsoft Teams, Slack, or other business tools. The Integrations section lets you set up new connections and monitor existing ones to ensure data flows correctly between systems. Integrations section to connect HRMS, payroll, Slack, and Microsoft Teams *** ### User authentication Set the default login method for your organization. Empuls supports Google, Microsoft, Slack, and custom SAML 2.0 SSO. With single sign-on, employees access Empuls alongside other corporate apps without re-entering credentials, and you manage user access through your chosen identity provider. User authentication options including Google, Microsoft, Slack, and SAML 2.0 SSO *** ### AI settings Configure how AI features work across your Empuls instance. AI settings page with moderation, writing suggestions, and skill mapping controls **AI content moderation** — Automatically detect and flag inappropriate or non-compliant content. Review flagged items and take action from a centralized report. **AI writing suggestions** — Enable smart suggestions for employees writing recognition citations, posts, or nominations to make communication faster and more impactful. **AI skill mapping** — Analyze employee profiles, roles, and activities to suggest relevant skills, helping build skill matrices and identify learning gaps. **Flagged content** — View a report of all content flagged by the AI moderation system. ## Next steps Add employees individually or in bulk, manage roles, handle exits, and delegate accounts. Apply your organization's logo, colors, and visual identity to the platform. Create automated recognition budgets and allocate them to managers and teams. Manage your plan, billing contact, invoices, and redemption wallets. # AI settings Source: https://help-empuls.xoxoday.com/admin/ai/ai-settings Configure AI features in Empuls: enable or disable AI-assisted recognition, smart nudges, sentiment analysis, and content generation tools for your organization. The AI Settings panel gives Super Admins centralized control over all AI-powered features on Empuls. From a single screen, you can enable content moderation that automatically blocks inappropriate posts, turn on AI writing assistance to help employees craft better recognition messages, and activate skill mapping that surfaces soft skills from recognition data. Each feature operates independently and can be toggled on or off at any time without affecting the others. ## Accessing AI Settings Navigate to **Reports and Admin > AI Settings > AI Permissions** to reach the configuration panel. Only Super Admins can enable or disable AI features. Managers and employees see the results of these settings but cannot change them. *** ## AI Content Moderation AI Content Moderation uses OpenAI's Moderation API to automatically evaluate user-generated content before it is published on the platform. When flagged content is detected, it is either blocked silently or blocked and reported for admin review, depending on your configuration. ### Where moderation applies Content moderation is enforced across: * Social feed posts * Comments * Award citations * Q\&A submissions * Wishboard wishes ### How to enable AI Content Moderation Go to **Reports and Admin > AI Settings > AI Permissions**. AI Permissions page under Reports and Admin > AI Settings Click the toggle next to **AI Content Moderation** to enable it. AI Content Moderation toggle being enabled in AI Permissions Select one of two options: * **Block** — Automatically prevents flagged content from being published. The author receives a notification explaining the policy violation. * **Block or Report** — Blocks flagged content and also sends the admin an email and push notification for review. Check the option you want and click **Enable**. Moderation mode selection with Block and Block or Report options ### How content moderation works in practice **For employees submitting content:** 1. The employee submits a post, comment, citation, or wish. 2. The content is sent to OpenAI's Moderation API for evaluation (completed within 2–3 seconds). 3. If the content violates community guidelines, it is blocked from publishing and the employee sees a message explaining the violation. 4. If the content is appropriate, it is published normally. **For admins:** * You receive an email and push notification whenever content is flagged (when using "Block or Report" mode). * All flagged items are available for review under **AI Settings > Flagged Content**. ### Reviewing flagged content Navigate to **AI Settings > Flagged Content**. Flagged Content page under AI Settings showing moderated submissions Use the calendar to adjust the moderation timeline, then click **Apply**. Flagged Content date range picker with Apply button * A preview of the flagged content * The content type (post, comment, citation, etc.) * The submitting employee * The timestamp * The flagged category (e.g., harassment, hate speech) Click **View** on any row to see the full submission. Review flagged content regularly — especially when using "Block" mode only — so that you can identify patterns and address any cultural issues across teams. *** ## AI Writing Suggestions (AI Rewrite) AI Writing Suggestions help employees improve the quality of award citations and Wishboard messages. When enabled, an **Improve with AI** button appears in eligible text fields. Employees click the button to receive a refined, AI-generated version of their draft that preserves their intent while improving tone, clarity, and emotional impact. ### What AI Rewrite works on * **Citations for appreciation** — Recognition messages attached to peer or manager awards * **Wishboard messages** — Birthday, work anniversary, and new joiner greetings ### How to enable AI Writing Suggestions Go to **Reports and Admin > AI Settings > AI Permissions**. AI Permissions panel for enabling AI Writing Suggestions Click the toggle next to **AI Writing Suggestions** (AI Rewrite) to enable it. AI Writing Suggestions (AI Rewrite) toggle being turned on Check the boxes for the options you want to activate: * **Citations** — for appreciation and award recognition messages * **Wishes** — for birthdays, work anniversaries, and new joiners Click **Enable** to save. Content type checkboxes for Citations and Wishes with Enable button You can enable both options simultaneously. To disable, return to the same settings page and toggle the feature off. Changes take effect immediately. *** ## AI Skill Mapping AI Skill Mapping analyzes the recognition messages employees send and receive to identify soft skill patterns across your organization. When enabled, admins and managers can access skill reports at the individual, team, and organization level. ### How to enable AI Skill Mapping Go to **Reports and Admin > AI Settings > AI Permissions**. AI Permissions panel for enabling AI Skill Mapping Scroll to the **AI Skill Mapping** section within AI Permissions. AI Skill Mapping section within the AI Permissions screen Click the toggle to enable AI Skill Mapping, then click **Enable** to confirm. Skill analysis becomes active immediately for your account. AI Skill Mapping toggle enabled with Enable confirmation button For a full guide on reading skill reports and applying insights to talent decisions, see [AI-Powered Skill Mapping](/admin/ai/ai-skill-mapping). *** ## Summary of AI permissions | Feature | What it does | Who benefits | | ---------------------- | -------------------------------------------------------------- | ----------------------------- | | AI Content Moderation | Detects and blocks inappropriate content before it's published | Admins, all employees | | AI Writing Suggestions | Improves award citations and wish messages with AI | Employees writing recognition | | AI Skill Mapping | Surfaces soft skill insights from recognition data | HR, managers, admins | Disabling an AI feature removes it from the employee UI immediately. Employees relying on AI writing suggestions, for example, will no longer see the "Improve with AI" button until the feature is re-enabled. # AI-powered skill mapping Source: https://help-empuls.xoxoday.com/admin/ai/ai-skill-mapping Use Empuls AI skill mapping to automatically identify and tag employee skills from recognition data, helping HR build accurate skill profiles across the organization. AI-Powered Skill Mapping gives HR teams, managers, and admins a new lens into workforce capabilities — without adding new surveys or assessments. Empuls analyzes the recognition messages employees send and receive and uses that data to identify patterns in soft skills across individuals, teams, and the entire organization. The result is a set of reports that reveal where your team excels and where development opportunities exist. ## How it works Every time someone writes a recognition message — a peer award, a manager citation, or a nomination — the message contains signals about the behaviors and qualities being celebrated. Skill Mapping reads these signals at scale and categorizes them into four core competency areas. The more actively your team uses recognition, the richer and more accurate the skill insights become. AI Skill Mapping must be enabled by a Super Admin before skill reports become available. See [AI Settings](/admin/ai/ai-settings) for instructions on turning it on. ## Skill categories Skill Mapping identifies soft skills across four main categories: How well individuals or teams express ideas, share information, and engage others. A high score reflects strong verbal and written communication observed in recognition patterns. Relationship-building behaviors — empathy, collaboration, and the ability to work effectively with others. Useful for assessing team cohesion or identifying strong collaborators. Problem-solving, analytical reasoning, and the ability to evaluate situations thoughtfully. High scores signal readiness for roles requiring independent decision-making. Leadership indicators such as initiative, influence, and the ability to guide others. Use this to identify potential leaders for internal mobility or succession planning. Each category is further broken down into specific sub-skills, giving you a detailed picture rather than just a broad category score. ## Use cases ### Upskilling and learning path design Before investing in a learning program, use Skill Mapping reports to understand where individuals or teams have gaps. If critical thinking scores are low across a department, you can tailor training content specifically to that area rather than running generic programs. * Identify gaps and strengths to guide upskilling decisions * Assess talent readiness with a clear skill profile * Shape personalized learning paths with real-time data ### Internal mobility and hiring decisions Looking to fill a leadership role internally? Scan leadership and interpersonal skill scores to find employees who consistently demonstrate initiative and influence across their recognition history — people who might not appear on the shortlist based on title or seniority alone. ### Performance development conversations Use the **My Reports** and **My Team** tabs to add data-driven context to one-on-one check-ins and performance reviews. Instead of relying solely on manager observations, bring concrete skill trend data into the conversation. ### Team capability analysis for projects When assembling a project team, use team-level skill views to identify strong communicators, critical thinkers, and collaborators across departments. Compose teams with complementary skill profiles rather than defaulting to availability alone. ## Accessing skill reports Navigate to **Reports and Admin > Reports**, then select the **My Organization** tab. Locate the **Soft skills exhibited in award messages** card. Switch between the **Communications**, **Interpersonal Skills**, **Critical Thinking**, and **Leadership** tabs to explore detailed insights in each area. Go to **Reports and Admin > Reports**. Reports and Admin entry point on the Empuls dashboard Click the **My Organization** tab to view org-level skill data. You can also view data scoped to your own profile under **My Reports**, or your direct reports under **My Team**. My Organization tab selected in the Reports view Scroll to the **Soft skills exhibited in award messages** card. Soft skills exhibited in award messages card on the Reports page Click through the **Communications**, **Interpersonal Skills**, **Critical Thinking**, and **Leadership** tabs to see breakdowns by category and sub-skill. Skill category tabs for Communications, Interpersonal, Critical Thinking, and Leadership Use the filter panel to narrow the report by department, designation, grade, business unit, location, or cost center. Skill report filter panel for department, designation, grade, and location ## Reading your skill report When reviewing skill data, look for two key patterns: * **High-performing areas** — Skills consistently reflected in recognition messages, indicating established strengths in individuals or teams. These can be leveraged for project assignments, mentoring, or public recognition. * **Absent or low scores** — Potential skill gaps that may not be visible in standard performance data. Use these to inform development conversations or targeted training investments. Skill Mapping is most valuable when your recognition program is active. Encourage managers to write specific, behavior-focused recognition messages rather than generic praise — richer message content produces richer skill signals. ## Filters available You can slice the skill data across the following dimensions: * Department * Designation * Grade * Business unit * Location * Cost center This lets you, for example, compare communication skill profiles across two departments, or identify leadership indicators within a specific grade band. ## Things to keep in mind * Skill insights are derived from recognition data only. Results reflect the language used in award messages, not formal performance assessments. * Employees who send and receive fewer recognitions will have less data, leading to less complete skill profiles. * Review your core values and award structure periodically to ensure they are set up in a way that generates meaningful skill signals — vague award categories produce less specific skill data. Yes. Employees can view their own skill profile under the My Reports tab. They see the same four categories and sub-skill breakdown that managers and admins can see for them. Skill data is updated continuously as recognition messages are submitted. There is no fixed refresh cycle — new recognitions contribute to the skill model in real time. No. The current Skill Mapping feature focuses exclusively on soft skills across the four categories: Communications, Interpersonal Skills, Critical Thinking, and Leadership. Hard skills are not analyzed from recognition messages. Skill Mapping produces more reliable insights with a larger volume of recognition data. If your recognition program is new or underused, consider launching a recognition activation campaign before drawing conclusions from skill reports. ## Next steps Once you have reviewed your first skill report, use the insights to: 1. Define targeted learning paths for teams with identified gaps 2. Shortlist internal candidates for open roles based on skill fit 3. Bring skill data into your next round of performance reviews 4. Identify potential mentors or team leads based on leadership indicators For questions or support, email [cs@xoxoday.com](mailto:cs@xoxoday.com). # Em copilot Source: https://help-empuls.xoxoday.com/admin/ai/empuls-copilot Meet Em, the Empuls AI copilot that helps employees and admins navigate the platform, get answers to HR questions, and take actions faster through a conversational interface. Empuls Copilot is an AI-powered assistant — called **Em** — built directly into the Empuls dashboard. Instead of navigating menus to complete tasks, you type a prompt in plain language and Em responds with the action, data, or guidance you need. Copilot works for everyone on the platform: employees, managers, and admins each see capabilities tailored to their role and permissions. Whether you want to recognize a colleague, check your team's engagement trends, find out what you can redeem with your current points balance, or pull a budget report for the quarter — Copilot handles it through a single chat interface. ## How to access Copilot Look for **Copilot** in the left-hand navigation panel of the Empuls dashboard. Copilot entry in the Empuls left navigation panel Click **Copilot** to open the chat interface. Empuls Copilot chat window with welcome screen Enter your question or request in natural language. Copilot responds with real-time suggestions, direct actions, or data based on your role. Typing a natural language prompt into the Empuls Copilot chat You don't need to use specific command syntax. Copilot understands conversational prompts — describe what you want to do in plain language and Em will interpret and act on it. ## What Copilot can do Copilot capabilities are scoped to your role. The same chat interface serves all users, but the actions available and data returned reflect your permissions on the platform. ### Employees As an employee, you can use Copilot to manage your recognition activity, explore your reward balance, and find colleagues. **What you can do:** * Nominate peers for awards or recognitions * Check what you can redeem with your current points balance * Search the employee directory for contact details or reporting structure * Celebrate moments — send birthday wishes, work anniversary messages, or welcome new joiners * Ask questions about how features work on the platform **Example prompts:** * *"Nominate Aditi for going the extra mile"* * *"What can I redeem with 2,500 points?"* * *"Find contact details of Brian from Sales"* * *"Who's the manager for the Bangalore tech team?"* * *"Wish Raj happy birthday"* ### Managers Managers can use Copilot to monitor team engagement, identify underappreciated team members, and send awards without leaving the chat interface. **What you can do:** * Access team-level reports on engagement, awards, and reward usage * Identify team members who have not been recognized recently * Send awards or nominate team members directly * Get AI-generated suggestions for recognition messages * Review team activity trends by period **Example prompts:** * *"Which of my team members haven't been recognized this month?"* * *"Show team reward usage for Q3"* * *"Send a 'Thank You' award to Lisa for last week's effort"* * *"Nominate Alex for the Team Player award"* * *"Summarize my team's engagement last quarter"* ### Admins Admins can use Copilot to generate reports, access platform analytics, and get help navigating configuration tasks. **What you can do:** * Generate reports on recognitions, nominations, budget usage, and redemptions * View organization-wide engagement trends and activity summaries * Access award and nomination data segmented by department or time period * Get guided help for setting up programs, automations, or settings * Surface engagement insights from survey and recognition data **Example prompts:** * *"Show me last month's budget usage by department"* * *"Give me a report on manager recognitions this quarter"* * *"Which departments have the lowest engagement scores?"* * *"How do I set up a milestone award for 5-year anniversaries?"* * *"Summarize recognition activity for the last 30 days"* ## Why use Copilot Navigating a full engagement platform can slow down the tasks you perform most often. Copilot removes that friction by letting you get things done through a conversation rather than a series of menu clicks. Key benefits: * **Saves time** — Complete common actions like sending recognitions or pulling reports in seconds * **Reduces friction** — New users can get started immediately without learning navigation patterns * **Surfaces insights** — Ask for engagement data in plain language without needing to configure a report manually * **Boosts recognition participation** — When recognizing a colleague is as easy as typing a sentence, it happens more often ## Example use cases Type a description of what the person did — for example, *"Sarah led the client presentation and it went really well."* Em will suggest an appropriate award type and generate a draft recognition message you can edit before sending. Ask Em directly: *"Which of my team members haven't received a recognition in the last 30 days?"* Copilot returns a list based on current recognition data for your team. Type *"What can I redeem with my current points?"* Copilot shows your balance and lists redemption options available in your region — gift cards, merchandise, experiences, and more. As an admin, type *"Show me Q2 budget usage by department."* Copilot pulls the data and presents it in the chat without requiring you to navigate to the reports section manually. Type *"Wish Priya on her work anniversary."* Em drafts a warm, personalized message that you can review and post to the Wishboard in one click. ## Tips for better prompts * **Be specific about the person or timeframe** — *"Show recognitions for the engineering team in March"* returns more useful data than *"Show recognitions"*. * **Describe the outcome you want** — *"Help me write a recognition for Jamie's project delivery"* produces better results than *"Write something nice"*. * **Ask follow-up questions** — If the first response isn't exactly what you needed, refine your prompt. Copilot maintains context within the conversation. Copilot's responses are based on your role and the data your account has access to. Employees cannot access other users' data or admin-level reports through Copilot. ## Getting help For questions or feedback about Empuls Copilot, reach out at [cs@xoxoday.com](mailto:cs@xoxoday.com). # Perks and benefits Source: https://help-empuls.xoxoday.com/admin/benefits/faqs Find answers to common questions about the reward marketplace on Empuls, covering setup, permissions, and troubleshooting. Yes, Xoxoday R\&R platform provides exclusive discount offers and cashback opportunities through its global rewards marketplace. Employees can access special deals, limited-time promotions, and merchant-funded discounts across categories like electronics, fashion, food, grocery, travel, and entertainment. These offers are tailored by geography to ensure local relevance, featuring popular brands such as Amazon, Flipkart, Nike, Starbucks, Carrefour, and more. In addition to discounts, the solution operates on a points-based system. When employees avail an offer through the platform and complete a purchase, they earn reward points. These points can be redeemed for brand gift cards, merchandise, experiences, or other catalog options, offering both instant savings and long-term value. The Xoxoday platform provides a diverse range of perks and benefits that enhance employee financial well-being and work-life balance. Key offerings include: • Tax-Saving Benefits: Redeemable allowances for meals, fuel, periodicals, and telecom expenses, structured for optimal tax efficiency. • Flexible Lifestyle Benefits: Customizable lifestyle spending accounts for perks in wellness, learning, financial services, and more. • Exclusive Discounts & Cashback: Access to discounted gift cards, curated deals, and cashback offers across thousands of global brands. • Early Wage Access & Loans: Seamless digital access to earned wages before payday, helping employees manage unexpected expenses. • Corporate Wellness Offers: Partnerships with leading providers for discounts on products (e.g., Samsung), wellness programs (e.g., ekincare), and financial services (e.g., Nova Benefits). Xoxoday, through its employee engagement and benefits platform, supports enterprise-wide discount programs across multiple markets while aligning with three key strategic goals. * Continuously provide and update a variety of discounts for employees and subsidiaries * Regional depth: The platform maintains strong merchant partnerships across key regions, offering curated catalogs of local and international brands and services in retail, dining, travel, wellness, and lifestyle categories. * Global breadth: Employees can access gift cards and offers across 150+ countries, ensuring global applicability. * Dynamic refresh: Discount content is continuously refreshed — outdated offers are removed, and new categories are introduced. Enterprises can curate content based on their requirements. Discounted vouchers displayed on the platform can be filtered to meet company standards. * Increase participant usage and deliver value to employees * Localized experience: Multi-language and multi-currency capabilities ensure employees across different regions access the platform in their local language and currency. * Seamless access: Employees use secure Single Sign-On (SSO) for frictionless login, with full support for mobile access on iOS and Android. * AI-driven engagement: Employees receive personalized recommendations, AI nudges, and automated reminders to explore and redeem offers. * Adoption programs: Dedicated Customer Success Managers work with HR and benefits teams to launch internal awareness campaigns, ensure early adoption, and drive sustained participation. * Analytics & reporting: Real-time dashboards track usage (logins, transactions, savings by region), with monthly and quarterly reviews to monitor adoption and optimize engagement. * Provide discounts and offers without additional fees for participants * No-cost participation: Employees can access all offers without incurring fees, ensuring meaningful discounts, localized purchasing power, and measurable savings. The employee discount program is promoted through a multi-channel approach designed to maximize visibility and engagement: * Targeted email campaigns: Personalized messages are sent directly to eligible employees and subsidiaries. * WhatsApp marketing: Opt-in communication enables instant updates, new offer reminders, and redemption notifications. * In-app notifications: Engage users directly within the platform, ensuring high visibility and immediate action. * Internal communication channels: Includes intranet posts, HR newsletters, internal emails, and other trusted organizational channels. Average KPIs by Channel * Email campaigns: Open rates of 40–60%, click-through rates of 12–18%, and redemption rates of 20–35%. * In-app notifications: Engagement rates of \~26% with click-through rates of 15–18%. * WhatsApp messages: Read rates above 80%, click-through rates of 15–25%, and conversion rates around 20%. * Internal channels: Engagement rates of 25–40%, with conversion rates depending on internal visibility and priority. * Web analytics: Metrics such as pageviews, unique visitors, bounce rates (\<18%), and average session duration (>4.2 minutes) are monitored to measure campaign effectiveness. Year-Long Marketing Plan * Marketing calendar: Created at the program launch with sample mailers and flyers. * Seasonal promotions: Combines seasonal and special-offer campaigns with ongoing communications. * Content refresh: Regular updates ensure continuous engagement and discovery of new offers throughout the year. ## Discount Program and Merchant Management The seller complies with all merchant and discount management responsibilities to ensure the program is accurate, valuable, compliant, and impactful. * Merchant Contracts and Offer Quality * The seller will maintain all merchant contracts and agreements required to deliver discount offerings. * The seller will ensure that all discount offers provided by merchants are valuable, accurate, and valid. * Compliance and Scope of Offerings * The seller will comply with all applicable laws, regulations, and tax implications related to the program. * The seller will deliver international, nationwide, and regional discounts that are measurable, meaningful, and represent true employee benefits not available through other means. * Merchant Visibility and Approval Process * The seller will provide a comprehensive list of participating merchants and their associated discounts to ensure there are no conflicts with company values or interests. * The enterprise retains the right to approve or decline new merchants or offers before launch. * The seller will alert the enterprise as new merchants or offers become available. * Offer Maintenance and Accuracy * The seller will maintain up-to-date offers on the platform, ensuring URL accuracy, merchant contact information, and timely removal of expired offers. * Partnership Prioritization and Issue Management * The seller will prioritize partnership satisfaction, advertising commitments, and timely responses to merchant inquiries. * The seller will be responsible for resolving any issues between participants and merchants once notified, and will inform the enterprise of such incidents during regular operational reviews. * Merchant Sourcing and Category Expansion * Upon request, the seller will actively source new merchants. * Upon request, the seller will increase offerings in specific categories to enhance program value. The seller ensures robust participant support, communication, and program education to maximize engagement and satisfaction. * Participant Support Channels * The seller provides multiple contact options for participants, including live phone support and an online web request form, ensuring timely and accurate resolution of inquiries and issues. * The seller will escalate participant complaints as appropriate to designated program owners. * Education and Guidance * The seller will provide detailed instructions, online tutorials, and other educational resources to help participants navigate the discount platform and utilize its features effectively. * Program Promotion and Engagement * The seller will actively promote the discount program to participants through marketing campaigns, contests, giveaways, and other engagement initiatives. * Marketing strategies and restrictions will be formalized in agreement with the enterprise and may include channels such as email, company news, merchant visits, opt-in methods, and loyalty points systems. * Communication Compliance and Governance * The seller will not distribute communications to participants without prior review and approval by the enterprise’s designated benefits team. * All communications will be distributed only to participants who have explicitly opted in to receive them. Yes. Merchants included in the discount platform must meet strict compliance requirements, and the following categories are excluded: • Firearms, explosives, or weapons. • Pornographic or adult-related products and services. • Alcohol and tobacco products. • Prescription drugs and medical services. • Illegal substances or related services. • Small independent sellers and multi-level marketing products and services (e.g., Amway, Tupperware, Avon, Discovery Toys, Cookie Lee, Prepaid Legal Services). This ensures the discount program maintains high ethical standards and compliance with organizational policies. The Xoxoday benefits platform is designed to accommodate special requirements and strategic priorities set by enterprises, particularly when it involves exceptions for specific merchants or categories. * Special Requirements and Exemptions * The platform can support exceptions for merchants or partners with existing strategic relationships with the organization, even if those partnerships were not initially part of the discount or benefits program. * Suppliers or partners that have existing contracts or relationships outside the discount program — and where participation involves no cost or fee — are exempt from paying any program-related fees. * Fee-Free Participation and Compliance * There will be no charge to current discount providers leveraged through corporate contracts or existing relationships. * These agreements will remain ongoing and indefinite, as long as they continue to meet the program’s participation requirements. * The program’s strategic priorities include continuous expansion of discount variety and offerings. * The supplier (platform provider) will enter into merchant agreements with no startup fees, no maintenance costs, no ongoing percentage of sales, or any other charges. * Relationships with the same merchants that involve fees for other employer programs are outside the scope of this fee exclusion. * The list of exempt merchants may be expanded in the future, and the supplier must uphold the agreement to include them. * Examples of Fee-Exempt Relationships * Fitness center partnerships: Existing and future agreements offered at no cost. * Childcare service partnerships: Existing and future collaborations offered at no cost. * Global merchant relationships: Existing and future global partnerships with no fees. * Local merchant relationships: Existing and future local merchant partnerships at no cost. # Health & wellness Source: https://help-empuls.xoxoday.com/admin/benefits/health-wellness Offer employees comprehensive health and wellness benefits through Empuls by integrating with leading providers for medical, mental health, fitness, and preventive care. The Health & Wellness category in Empuls brings preventive care, fitness, mental health support, and home care services into a single place. Employees can use their reward points to access these services individually, and employers can purchase wellness benefits in bulk to provide programs across the entire team simultaneously. Empuls partners with leading providers — including Apollo, ekincare, Mfine, Practo, CultFit, Trueworth, and Tata 1mg — to offer exclusive rates that maximize value for both employees and organizations. ## Why health & wellness benefits matter Investing in employee wellbeing delivers measurable outcomes: * **Healthier habits** through easy access to preventive and corrective healthcare * **Improved morale** by providing meaningful perks beyond salary * **Better productivity** as healthy employees focus more effectively * **Reduced absenteeism** with early detection and timely care * **Stronger employer brand** as a company that visibly invests in its people * **Lower healthcare costs** through preventive care and discounted partner rates ## Available wellness services Employees can access the following categories through the Health & Wellness section: | Category | Description | | ------------------------ | ---------------------------------------------------------------------------------------------------- | | Health checkups | Routine screenings, diagnostic tests, and preventive health packages via leading diagnostic partners | | Pharmacy | Medicines and health supplies at partner rates | | Doctor consultations | In-person or online consultations with certified doctors | | Mental health assistance | Counselling, therapy, and mental wellness programs (EAP) | | Gym subscriptions | Access to fitness centers such as CultFit | | Home care | In-home nursing, elder care, and physiotherapy services | ## Employee: redeem points for health & wellness Employees can redeem their Empuls reward points directly for wellness services. No additional payment is required if points cover the full value. Access the Empuls platform using your credentials. Go to **Redeem > Health & Wellness** tab. Choose the service you need — for example, **Doctor consultations** or **Gym subscriptions**. Select the service or product from the list displayed for that category. Click **Book Now**, then click **Place Order** to confirm. Your booking details are sent to your registered email. The more reward points you have, the wider your selection. You can earn points through peer recognition, completing surveys, and participation in programs. ## Admin: enable company-sponsored wellness benefits As an admin, you can purchase wellness benefits in bulk so that all employees — or a defined group — receive access without needing to spend individual reward points. Access the Admin interface in Empuls. Navigate to **Programs > Employee Benefits > Wellness Benefits**. Choose the wellness category you want to sponsor — for example, **Gym Membership** or **Mental health assistance**. Select the provider from the list (such as CultFit). Review available packages, tiers, and included privileges. Fill in the number of employees you want to enroll, their work email addresses, and phone numbers. Click **Enquire**. The Empuls team responds with pricing details and confirms the benefit activation once requirements are agreed upon. Company-sponsored wellness benefits are available at prices lower than the public market rate. Empuls co-sponsors the benefit to make it accessible to every employee without stretching your budget. ## Wellness programs and engagement features Beyond individual service redemption, Empuls supports structured wellness programs to boost team-wide adoption: * **Stepathons and activity challenges** — Run step count competitions with leaderboards and recognition for top participants * **Google Fit and Apple Health sync** — Employees connect fitness apps to automatically track activity and earn progress milestones * **Milestone recognition** — Reward employees who reach wellness goals with points or badges * **Wellness leaderboards** — Display team progress to encourage friendly competition and sustained engagement For detailed setup and participation instructions, see the dedicated fitness challenge guides: Browse challenges, connect your device, and track your progress on the leaderboard. Enable templates, configure milestone rewards, and monitor participation. Launch a 30–45 day wellness challenge covering steps, mindfulness goals, and sleep habits to quickly drive adoption of health benefits across your organization. ## Company-sponsored benefit categories When purchasing in bulk, admins can sponsor the following wellness services for groups: * **Health checkups** — Corporate health packages for annual or quarterly preventive screenings * **Insurance** — Group medical insurance or supplemental health plans * **Pharmacy** — Employee credits or vouchers for medicines and health essentials * **Doctor consultations** — Teleconsultation packages or in-clinic visit vouchers * **Mental health assistance** — Employee Assistance Programs (EAPs), therapy subscriptions, and wellness coaching * **Gym subscriptions** — Corporate gym memberships for individuals or entire teams * **Home care** — Corporate tie-ups for home nursing and elder care services ## Contact and support For queries about health and wellness offerings for your teams, write to [cs@xoxoday.com](mailto:cs@xoxoday.com). Yes — employees can redeem reward points for any service listed in the Health & Wellness catalog. If the points balance does not fully cover the cost, an additional payment option may be available depending on the service. No. Bookings made through Empuls are handled within the platform. You do not need to register separately with providers like Apollo or CultFit to access services. The Empuls team contacts you to confirm pricing and requirements, then activates the benefit for the employees you listed. Employees receive an email notification when their access is ready. Yes. Individual reward-point redemption and company-sponsored programs are independent features. You can run both simultaneously. # Multi benefits card Source: https://help-empuls.xoxoday.com/admin/benefits/multi-benefits-card Set up and manage the Empuls Multi-Benefit Card for your organization: configure tax-exempt categories, set employee allocations, and track card usage across your workforce. Tax-saving benefits are financial benefits you offer employees to maximise their savings by reducing taxable income based on local government regulations. By spending eligible amounts through the Empuls Multi-Benefit Card, employees lower the income subject to taxation, reducing their tax liability and increasing take-home pay. You can help employees maximise savings by offering tax-saving allowances like books and periodicals, plus reimbursements for meals, telephone, and fuel expenses. Under the income-tax limits w\.e.f. 1 April 2026, the card unlocks over **₹1.93 lakh of tax-free spending per employee each year** across meals, fuel, telecom, and books, translating to roughly **₹60,000+ in annual tax savings at the 30% slab**. Contact [cs@xoxoday.com](mailto:cs@xoxoday.com) to enable the Multi-Benefit Card for your organization. ## Empuls Multi-Benefit Card The Empuls Multi-Benefit Card simplifies employee tax benefits with a single card covering allowances for books, meals, fuel, telecom, and more. It streamlines your team's tax-saving efforts by replacing traditional methods like food coupons and fuel cards. You load tax-free benefits electronically, and employees spend them online or in-store using virtual and physical RuPay cards. ## Why Empuls Multi-Benefit Card Activate individual employee wallets in minutes. Zero waiting period once KYC is approved, with full tax compliance built in. Tax-free funds are accessible through a virtual card for online spend and a physical RuPay card for in-store and at-pump purchases. Live utilization reports on the admin dashboard, with 100% digital onboarding and spend tracking for both employees and the organization. Employees access the digital card, view balances, and review transactions on iOS and Android. ## Activating the Multi-Benefit Card You can activate the program in less than 10 minutes. Log in to your Empuls account and customise the flexible benefits program by selecting from 20+ categories such as meals, travel, fuel, fitness, books, and telecom. Activate and recharge the card with allocated funds to enable the employee benefits program. Specify prepaid card rules, per-category limits, and the card design tailored to your employees' needs. Distribute the Multi-Benefit Card to your employees. Manage prepaid cards by tracking detailed metrics, including payroll, activation, usage, and financial reports for comprehensive oversight. ## Categories on a single card | Allowance | Used for | Example merchants | | --------------------------- | ----------------------------------------------------------------------------------------------- | ----------------------------------- | | **Meal allowance** | Dining expenses, groceries, food delivery via meal gift vouchers | Swiggy, Zomato, Zepto, Domino's | | **Fuel allowance** | Work-related fuel costs and driver salary reimbursement | HP, Indian Oil, Bharat Petroleum | | **Books & periodicals** | Books, journals, and learning platforms to keep employees up-to-date with industry advancements | Online learning vendors, bookstores | | **Telecom allowance** | Mobile and broadband bills | Airtel, Jio, BSNL, ACT | | **Leave Travel Assistance** | Eligible travel under LTA rules | Per bills uploaded | | **Reimbursement** | Eligible work expenses with proof | Per your policy | | **Miscellaneous** | Catch-all for other configured benefits | Per your policy | ## What changed w\.e.f. 1 April 2026 India's updated income-tax rules significantly raised the tax-free ceilings on several benefit categories. Plan allocations to take advantage of the new limits. | Benefit category | Before | w\.e.f. 1 April 2026 | Annual impact | | ----------------------------------------- | ---------------- | -------------------- | --------------------------------------------------------------- | | Gift cards & vouchers | ₹5,000/year | ₹15,000/year | 3× higher tax-free gifting | | Meal vouchers | ₹50/meal | ₹200/meal | Up to \~₹1.05 lakh/year (2 meals × 22 working days × 12 months) | | Children education allowance (old regime) | ₹100/month/child | ₹3,000/month/child | ₹36,000/year per child | | Hostel allowance (old regime) | ₹300/month/child | ₹9,000/month/child | ₹1.08 lakh/year per child | ### Win-win opportunity **For employees** * Higher take-home value through tax-efficient rewards and daily benefits. * More meaningful recognition with bigger gifting moments and no tax dilution. * Increased disposable income from meal and allowance benefits. **For employers** * No extra cost: deliver higher value within the same compensation budget. * Optimised pay structure to maximise employee take-home value. * Competitive edge in talent attraction and retention. ### How Xoxoday helps you capture this opportunity **1. Rewards & recognition (₹15,000 gift exemption)** * Scale recognition programs: spot awards, peer-to-peer recognition, and performance incentives. * Automate festive gifting: schedule Diwali, Holi, and New Year gifts once and auto-distribute. * Celebrate milestones: birthdays, work anniversaries, and onboarding gifts triggered via workflows. * 10,000+ reward options across gift cards, experiences, travel vouchers, and merchandise. * Compliance-ready reporting with automatic audit trails and tax reports. **2. Benefits & perks (up to ₹1.05 lakh in meal benefits plus other allowances)** * Multi-wallet benefits infrastructure for meal, fuel, telecom, books, education, and hostel allowances on one platform. * Meal benefits at scale: ₹200/meal tax-free via Swiggy, Zomato, and restaurants. * Separate tracking so tax-deductible allowances are managed independently from gift card limits. * Flexible redemption: employees choose where and when to use their benefits. * Real-time compliance with auto-calculated tax exemptions and spend limits. ## Before you start * You must be a **Super Admin** to access the Tax Benefit dashboard. * This feature is available to organizations with employees in India and a configured benefits provider partnership with Xoxoday. * Beneficiaries receive a payment card. KYC must be completed by each beneficiary before transactions are accepted. ## How it works Money is added to a single org-level account via Indian bank transfer (IMPS, NEFT, or RTGS). The available balance is split across benefit categories when you allocate funds. Pick employees in bulk by uploading a CSV or by filtering on department, designation, grade, location, business unit, or cost center. Empuls validates each row, surfaces errors in a downloadable report, and issues a card to every successful beneficiary. Upload a CSV that lists the amount each beneficiary should receive per category. Empuls validates the file, shows warnings and invalid rows, and disburses funds in a background job. Track org-level totals (allocated, utilized, unused), per-employee balances across categories, and per-category spend including declined transactions with reasons. ## Dashboard overview The Tax Benefit dashboard is your starting point. It shows: * **Organization account balance**: total funds held in the org wallet and the amount currently available for allocation, in INR. * **Action buttons**: **Allocate fund** opens the allocation wizard; **+ Add funds** displays bank-transfer details for topping up; the popover next to the balance links to the **Account statement**. * **Summary cards**: Total Allocated, Total Utilized, Employee Unused Balance, and Beneficiaries. Each card navigates to the corresponding detail page. * **Category cards**: one card per active benefit category showing unused balance, so you can see at a glance where money is sitting. ## Add funds to the organization wallet On the Tax Benefit dashboard, click **+ Add funds** next to the account balance. A modal opens with the Xoxoday HDFC bank account details: account holder, account number, IFSC code, and bank name. Use the **copy** icon next to each field to grab the values for your finance team. Send funds from your corporate bank account using IMPS, NEFT, or RTGS, following the transfer rules listed in the modal. Funds typically reflect in the org wallet within one business day depending on the transfer mode. Funds added to the organization wallet are non-refundable once allocated to beneficiaries. Confirm category caps with your finance team before allocating. ## Add beneficiaries The Add Beneficiary wizard is a three-step, full-screen flow. From the **Beneficiaries** page, click **+ Add beneficiary**. You can pick one of two methods: **Paste data (filter-based)** — Build a condition by picking from department, designation, grade, location, business unit, cost center, or individual users. The picker supports multi-select search so you can mix several criteria into one rule. **Upload CSV** — Download the sample CSV, fill in employee identifiers, and upload the file. Empuls validates each row. Empuls runs validation as a background job. You'll see: * **Success count**: rows ready to add as beneficiaries. * **Error count**: rows that failed validation, with a downloadable error report so you can fix and re-upload. Click **Confirm** to enroll the validated beneficiaries. A progress bar tracks the submission; the final screen shows how many beneficiaries were added successfully. Each beneficiary's card status starts at **KYC Pending**. The beneficiary must complete KYC with the card provider before the card becomes **Active** and can be used for transactions. ## Allocate funds to beneficiaries The Allocate Funds wizard is also a three-step flow. On the dashboard, click **Allocate fund**. The wizard shows the current available balance. Download the sample template, fill in beneficiary email, benefit category, and amount per row, then upload the file. Empuls validates the file type and size before accepting it. Empuls validates each row in the background. The summary shows: * **Success**: rows ready to disburse. * **Warning**: rows that disburse with caveats (for example, partial allocation due to insufficient category cap). * **Invalid**: rows that fail (unknown email, disabled user, invalid category). Download the corrected file to fix and re-upload. Click **Confirm** to submit the allocation. A progress bar tracks disbursement. The final summary shows: * **Users recognized**: beneficiaries who received funds. * **User accounts disabled**: skipped because the user is no longer active. * **Failed**: allocations that couldn't be completed, with a downloadable failure report. Background jobs poll every 5 seconds and time out after 15 minutes. If you close the browser, the wizard remembers the in-progress job via the URL and can resume. ## Reporting and statements | Page | What it shows | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Account statement** | Every credit and debit on the org wallet with transaction ID, date, credit, debit, and running balance. Filter by date range. | | **Total allocated** | Every allocation transaction: receiver, allocation ID, benefit category, date, amount. | | **Total utilized** | Every spend transaction by employees, scoped to the same columns as Total allocated. | | **Employee unused balance** | Per-employee balance across all categories (Meals, Fuel, Travel, Telecom, Books, Reimbursement, Miscellaneous) with the first column pinned for scrolling. | | **Category details** | Drill into a single category to see allocations, spend transactions, monthly spend, and a sub-page of declined transactions with decline reasons. | | **Beneficiary details** | Per-employee profile with Overview (totals + per-category cards) and Transactions (credit/debit history, search, and date filter). | ## Limits and gotchas * Amounts are stored and displayed in INR using the Indian numbering system (lakhs and crores). * Card issuance and KYC are handled by the card provider, not Empuls. Failed KYC blocks card activation but does not block beneficiary creation. * Declined transactions show a decline reason (insufficient balance, blocked merchant category, etc.) on the **Transaction decline** sub-page within Category details. * Tax benefits is independent of reward points and the redemption wallet. It cannot be funded from or paid out to those balances. ## Related Manage your Empuls subscription and view invoices. The separate wallet that funds reward redemptions. Add employees who can be enrolled as beneficiaries. # Automated budgets Source: https://help-empuls.xoxoday.com/admin/budgets/automated-budgets Create automated recognition budgets that run on a schedule — weekly, monthly, or quarterly — so your programs always have funds without manual top-ups. Rather than manually sending points each month, create automated budgets that run on a schedule (weekly, monthly, or quarterly) so your recognition programs always have funds available without manual intervention. Allocate fixed amounts or prorate distributions based on team size. ## Create an automated budget In the Admin Hub, navigate to **Manage Budgets** and click **Create New Automated Budget**. Create new automated budget The budget creation wizard opens. Click **Let's Begin** to start. Enter a **budget name** and **description**, then link the award types that will draw from this budget. For example, a "Peer Recognition Budget" linked to your peer awards ensures managers only use these funds for that specific program. Select how points are distributed to recipients: * **Fixed** — Every recipient gets the same number of points per distribution run. Use this for equal-distribution programs where team size doesn't matter. * **Prorated** — Points are distributed based on a rule you define. Select a proration rule from the dropdown: * Number of employees in a department * Number of employees in a business unit * Number of employees in a cost center * Number of employees mapped to an HR representative * Number of direct reports * Number of direct and indirect reports Then enter the total points to distribute per run. The system calculates each recipient's share based on the rule. Check **Recover unused points** if you want unspent points returned to the budget at the end of each cycle rather than carried over to the next period. Click the **pen icon** to choose who receives the budget. You can: * Select individuals manually * Use advanced filters (by designation, location, department, function, etc.) * Paste a list of recipients directly Configure when and how often the budget distributes: * **Start date** — Select the first distribution date using the calendar. * **Repeat cycle** — Choose weekly, monthly, quarterly, or another frequency. * **Number of runs** — Specify how many times the distribution should occur before the budget expires. Review all settings in the summary. Click **Confirm and Create** to activate the automated budget. Confirm automated budget ## FAQs Budgets can be distributed on any recurring schedule. Common choices are monthly (for ongoing recognition programs), quarterly (for performance-tied programs), and annually (for long-service awards or end-of-year programs). You set the frequency when creating the budget. You can assign budgets to individual users, managers, teams, or filtered groups based on attributes like designation, location, or department. Use advanced filters during budget creation to target the right recipients without manually listing them. Fixed allocation gives every recipient the same number of points regardless of team size. Prorated allocation scales the distribution based on a rule — for example, a manager with 10 direct reports receives more points than a manager with 3, so both can meaningfully recognize their teams. If you checked **Recover unused points** during budget creation, unspent points return to the budget pool at the end of each cycle. If this option is unchecked, points carry over to the next cycle or remain in the recipient's budget wallet. To edit, pause, duplicate, or audit an automated budget after creation, see [Manage budgets](/admin/budgets/manage-budgets). # Manage budgets Source: https://help-empuls.xoxoday.com/admin/budgets/manage-budgets Create recognition budgets, allocate points to managers and teams, set fixed or prorated distributions, pause and reactivate budgets, and monitor spending. Budgets in Empuls control how recognition points are distributed to managers and employees. Allocate fixed amounts or prorate distributions based on team size, edit budgets at any time, pause or reactivate them, and monitor spending across the organization. Keep your redemption wallet balance in sync with total outstanding redeemable points. When employees redeem points for vouchers, the amount is settled from your organization's redemption wallet. An underfunded wallet will interrupt the redemption experience. ## Video walkthrough