> ## Documentation Index
> Fetch the complete documentation index at: https://help-empuls.xoxoday.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI settings

> Enable or disable AI Content Moderation, AI Writing Suggestions, and AI Skill Mapping from the admin panel, and review flagged content in one place.

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.

<Info>
  Only Super Admins can enable or disable AI features. Managers and employees see the results of these settings but cannot change them.
</Info>

***

## 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

<Steps>
  <Step title="Open AI Permissions">
    Go to **Reports and Admin > AI Settings > AI Permissions**.

    <Frame>
      <img src="https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai1.png?fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=330f46f0db01c7a9fb302504709de241" alt="AI Permissions page under Reports and Admin > AI Settings" data-og-width="1853" width="1853" data-og-height="886" height="886" data-path="images/ai1.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai1.png?w=280&fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=1d54b53f8e34dfce90ddc9d5be755dd0 280w, https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai1.png?w=560&fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=4f7c8f405c6599fae234533d490a595d 560w, https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai1.png?w=840&fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=cb5f61256b5a942d4ff808954c0e9196 840w, https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai1.png?w=1100&fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=657e2de5f5fe731c5d5a13ecedf28c8c 1100w, https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai1.png?w=1650&fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=5b59f6604e760d6fc084cc68dc04ee79 1650w, https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai1.png?w=2500&fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=b997cf1f95d24902cae55506a0a23e06 2500w" />
    </Frame>
  </Step>

  <Step title="Toggle on AI Content Moderation">
    Click the toggle next to **AI Content Moderation** to enable it.

    <Frame>
      <img src="https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai_2.png?fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=65125bb0b7818b977b5d7ac200c387ec" alt="AI Content Moderation toggle being enabled in AI Permissions" width="1855" height="912" data-path="images/ai_2.png" />
    </Frame>
  </Step>

  <Step title="Choose a moderation mode">
    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**.

    <Frame>
      <img src="https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai2.png?fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=d87cd5f2ba8abcfb11d8742aeae7ad27" alt="Moderation mode selection with Block and Block or Report options" width="1852" height="912" data-path="images/ai2.png" />
    </Frame>
  </Step>
</Steps>

### 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

<Steps>
  <Step title="Open Flagged Content">
    Navigate to **AI Settings > Flagged Content**.

    <Frame>
      <img src="https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai3.png?fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=016ac7f2b26d9a9016a65e4003954a71" alt="Flagged Content page under AI Settings showing moderated submissions" width="1856" height="911" data-path="images/ai3.png" />
    </Frame>
  </Step>

  <Step title="Set the date range">
    Use the calendar to adjust the moderation timeline, then click **Apply**.

    <Frame>
      <img src="https://mintcdn.com/empuls/AqG_34P8O15DfwCy/images/flagged_content.png?fit=max&auto=format&n=AqG_34P8O15DfwCy&q=85&s=5851257b56a5260c3c006fc0f239940e" alt="Flagged Content date range picker with Apply button" width="2406" height="1306" data-path="images/flagged_content.png" />
    </Frame>

    * 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.
  </Step>
</Steps>

<Tip>
  Review flagged content regularly — especially when using "Block" mode only — so that you can identify patterns and address any cultural issues across teams.
</Tip>

***

## 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

<Steps>
  <Step title="Open AI Permissions">
    Go to **Reports and Admin > AI Settings > AI Permissions**.

    <Frame>
      <img src="https://mintcdn.com/empuls/iHWcXX4tOrECrE_5/images/ai_first.png?fit=max&auto=format&n=iHWcXX4tOrECrE_5&q=85&s=5b7d62957b253f3f072a426f5710adc4" alt="AI Permissions panel for enabling AI Writing Suggestions" width="1856" height="906" data-path="images/ai_first.png" />
    </Frame>
  </Step>

  <Step title="Toggle on AI Rewrite">
    Click the toggle next to **AI Writing Suggestions** (AI Rewrite) to enable it.

    <Frame>
      <img src="https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai5.png?fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=3f1c9626be07254f1eff52fe27c4dd17" alt="AI Writing Suggestions (AI Rewrite) toggle being turned on" width="1852" height="907" data-path="images/ai5.png" />
    </Frame>
  </Step>

  <Step title="Select the content types to enhance">
    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.

    <Frame>
      <img src="https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai6.png?fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=c3c43f81b4da8d2355c08a4ccc96143c" alt="Content type checkboxes for Citations and Wishes with Enable button" width="1857" height="917" data-path="images/ai6.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  You can enable both options simultaneously. To disable, return to the same settings page and toggle the feature off. Changes take effect immediately.
</Note>

***

## 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

<Steps>
  <Step title="Open AI Permissions">
    Go to **Reports and Admin > AI Settings > AI Permissions**.

    <Frame>
      <img src="https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai_second.png?fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=01b3b60ce9fb1d99e188ffcb62008444" alt="AI Permissions panel for enabling AI Skill Mapping" width="1857" height="907" data-path="images/ai_second.png" />
    </Frame>
  </Step>

  <Step title="Go to AI Skill Mapping">
    Scroll to the **AI Skill Mapping** section within AI Permissions.

    <Frame>
      <img src="https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai7.png?fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=15049f79ba6b8ff6c7a552c7cb89d32e" alt="AI Skill Mapping section within the AI Permissions screen" width="1855" height="907" data-path="images/ai7.png" />
    </Frame>
  </Step>

  <Step title="Toggle on and confirm">
    Click the toggle to enable AI Skill Mapping, then click **Enable** to confirm. Skill analysis becomes active immediately for your account.

    <Frame>
      <img src="https://mintcdn.com/empuls/F1KGIsi9lskGN6KX/images/ai8.png?fit=max&auto=format&n=F1KGIsi9lskGN6KX&q=85&s=4aa4e2b271251d1c45e999ea6d3e1dbb" alt="AI Skill Mapping toggle enabled with Enable confirmation button" width="1855" height="913" data-path="images/ai8.png" />
    </Frame>
  </Step>
</Steps>

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          |

<Warning>
  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.
</Warning>
