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

# Settings

> Organisation administration: feature flags, members, unmapped identity attempts, chat, email, fiscal calendars and Secrets. Developer pages are under Platform → Developers.

**Settings** (`/platform/feature-flags` — labeled "Settings" in the sidebar) is the organisation-administration surface. The page is a tab group of administrative concerns; the sidebar entry lands you on Feature Flags by default. The pages developers use to operate the platform — External Apps, Personal keys (all people), Forge MCP and Webhooks — are under Developers, which opens [External Apps](https://docs.gloo.com/forge/console/platform/external-apps).

![Settings](https://mintcdn.com/gloo-b243725a/Ndtg9NEpwGc2OULA/forge/images/console/platform/settings-light.png?fit=max\&auto=format\&n=Ndtg9NEpwGc2OULA\&q=85\&s=3fa1e2d452cb8a99a1f8f4edf1ef9025)

Settings — Forge Console at `/platform/feature-flags`

## What you can do

Each tab is its own admin page under the same tab bar. **Secrets** is the exception: it opens the Secrets pages, which show their own tabs in place of this bar.

* **Feature Flags** — toggle workspace-scoped feature flags. Flags gate experimental UI and behavior; every flag has an owner and a stability label.
* **Members** — manage workspace memberships. Invite users and review the full member roster, which supports column sorting (name, email, entitlement count, status, join date — alphabetical by default), free-text search across name/email/entitlement, and faceted filters by status (linked/pending) and entitlement bucket (including an "ungranted" facet). Select rows to bulk-grant or bulk-revoke entitlements, and export the current filtered view to CSV. Per-member access is managed from the row's **Manage** action.
* **Identity** (`/platform/identity/unmapped`, titled **Unmapped Identity Attempts**) — inbound external users, such as a Slack message author or an OAuth callback, that Forge could not match to a person. It is not where sign-in providers are configured. See [Identity](#identity) below.
* **Chat** — workspace-level chat configuration: default channel topology, relevancy thresholds, syndication targets. The **Reactions & Memory Weighting** card tunes how message reactions and pins steer agent context assembly and long-term-memory promotion: the per-session pin limit, the default weight applied to any emoji not in the table, a net-negative exclusion toggle (hard-exclude down-voted messages from agent context), and an editable emoji-weights table. These defaults apply platform-wide and are admin-gated. The LTM promotion threshold (the net reaction value that archives a chat message to long-term memory) moved to [Knowledge › Settings](https://docs.gloo.com/forge/console/knowledge.md#settings), where it is edited with the other learning settings; the card links there.
* **Email** — inbound email routes, senders and deliveries, and the inbound email token.
* **Fiscal Calendars** (`/platform/fiscal-calendars`) — fiscal years and periods used by close and accounting work.
* **Secrets** (`/platform/vaults`) — opens the Secrets pages, which have their own tabs: [Vaults](https://docs.gloo.com/forge/console/platform/vaults) holds named secrets with rotation and member access, and [Environments](https://docs.gloo.com/forge/console/platform/environments.md) (**Connections**, **Instances**, **Mappings**) pushes those secrets to Convex, GitHub and Vercel deployment targets. The sidebar keeps **Settings** highlighted on every Secrets page. Credentials that Forge presents to a vendor are not here; they are under [Vendors → Credentials](https://docs.gloo.com/forge/console/platform/credentials.md).

## Who can change configuration

Each configuration change in the Console needs an administrator permission and is recorded. Every write adds one `config` event to the audit trail, which names the person who made the change and what changed.

| Configuration | Read | Change | Audit event |
| - | - | - | - |
| Feature flags and their targets | `grants:read`, `policies:read` and `audit:read` | `platform:manage` | `feature_flag_set`, `feature_flag_target_added` / `_updated` / `_removed` |
| Platform settings (Chat card and other operator settings) | `platform:read` | Platform administrator | `platform_setting_set`, with the old and new value |
| Fiscal calendars (Platform › Fiscal Calendars) | `workflows:read` | `workflows:manage` | `fiscal_calendar_created` / `_updated` / `_removed` |
| Member invitations | Platform administrator | Platform administrator | `member_invited`, with the granted role, the position and any seat reactivation (never the email) |

Platform settings accept only operator settings, such as the chat reaction weights, the initial channel count, the procedure timeout ceiling and the inference budget enforcement mode. Any other key is refused, so internal state (the spend accounting epoch and migration checkpoints) cannot be read or changed here. Knowledge learning settings are changed under [Knowledge › Settings](https://docs.gloo.com/forge/console/knowledge.md#settings).

These changes are person-only. The Platform API and the MCP server cannot change flags, settings, fiscal calendars or members, and they cannot read flags, settings or members.

## Identity

The **Identity** tab lists each external identity that tried to reach Forge and did not resolve to a person. A Slack message from someone Forge does not know is the usual source.

* **Person integrity card** — with `workforce:read`, a **Workforce integrity** card at the top shows the latest comprehensive audit's status, its count of hard violations and operator decisions, and when it was updated. **Open workforce integrity** goes to [Integrity](https://docs.gloo.com/forge/console/workforce/integrity.md). With no audit recorded it says so.
* **Attempts table** — columns **Type** (the claim type), **External ID**, **Display Name**, **Last Attempt** and **Status** (**Pending** or **Dismissed**). It shows up to 100 attempts. Tick **Include dismissed** to show dismissed rows as well.
* **Link** — pick an employee or contractor and attach the attempt's identity to that person. **Link** is disabled when the attempt carries no email address.
* **Dismiss** — asks for a reason (for example a bot account) and hides the row from the default list.
* **Merge people** — choose a winning person and a losing person, give a reason, then **Review merge**. The confirmation lists the claims, seats, entitlements, rows and tables that move to the winner, and the personal agents that are archived. The losing person becomes an inactive permanent redirect. **Merge people permanently** cannot be undone, and the Console then opens the winner's person page.

When nothing is unmapped, the table is replaced by a short empty-state message.

## Key state to watch

* **Pending identity attempts** — each one is a person or bot whose messages Forge could not attribute. Link or dismiss it.
* **Workforce integrity status** — a status other than `COMPLETE`, or a non-zero hard-violation count, needs a look on [Integrity](https://docs.gloo.com/forge/console/workforce/integrity.md).

> [!NOTE]
>
> The sidebar label "Settings" here is distinct from the operator's profile settings at `/settings/profile` (reached from the user dropdown in the sidebar). Profile settings are per-operator; Platform → Settings is workspace-wide and admin-gated.

## Your profile settings

Your own profile settings live at `/settings/profile`, `/settings/avatar` and `/settings/notifications`. They are available only in the Console: the Platform API and MCP have no person actor, so there is no API or MCP tool for them.

Your own keys and MCP host sign-ins live at [Personal keys](https://docs.gloo.com/forge/console/settings/personal-keys.md) (`/settings/personal-keys`).

* **Profile** — change your display name and timezone. Your email and legal name are not editable here.
* **Avatar** — upload a PNG, JPEG, WebP or GIF image of up to 5 MB. Attach it within 15 minutes of uploading it, or upload it again. Any other file type, an SVG included, is refused with the reason shown under the upload button. Removing or replacing your avatar does not delete the stored image.
* **Notifications** — choose your channels (in-app, email, Slack), categories, digest frequency and quiet hours. The Slack DM toggle on My Work writes the same preferences.

These pages always act on your own current person. If your account has been merged into another person, or is suspended or inactive, the pages refuse to load or save until you sign in as your current person.

A platform admin can open another person's settings at `/settings/users/<userId>/profile`, `/avatar` and `/notifications`. An id that was merged into another person opens the person it was merged into, and an admin can still edit a suspended person's settings.

## Related surfaces

* [Members](https://docs.gloo.com/forge/console/platform/members.md) — the member roster and per-member access.
* [People](https://docs.gloo.com/forge/console/workforce/people.md) — the person a linked identity or merge lands on.
* [Integrity](https://docs.gloo.com/forge/console/workforce/integrity.md) — the workforce integrity audit.
* [External Apps](https://docs.gloo.com/forge/console/platform/external-apps) — the first Developers tab; Developers also holds Personal keys, Forge MCP and Webhooks.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.