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

# IT Settings

> Configure IT module settings for your organization, including module-level options managed via it_module_settings.

The IT Settings page (`/it/settings`) allows administrators to configure module-level settings for the IT core. It is guarded by the `it.settings.admin` permission and uses `useITModuleSettings` to load and persist configuration via the `it_module_settings` table.

## Overview

The page renders a single `ITModuleSettingsForm` inside a settings layout. On load it fetches existing settings; on submit it calls `upsert` (an upsert operation against `it_module_settings`). A dirty-state guard prompts users before leaving with unsaved changes. A guided tour is available via the Help button or `?tour=it-settings-tour` query parameter.

## Who it's for

Users with permission `it.settings.admin` (inner `RequirePermission` gate within the outer `ITViewGuard`).

## Before you start

* You must hold the `it.settings.admin` permission. Contact your system administrator if the settings link is not visible.

## Steps

<Steps>
  <Step title="Open IT Settings">
    Navigate to `/it/settings` or click the settings icon on the IT Operations overview page.
  </Step>

  <Step title="Review the current configuration">
    The form loads existing settings from `it_module_settings`. Fields are pre-populated with the current values.
  </Step>

  <Step title="Update fields as needed">
    Modify the relevant fields in the form.
  </Step>

  <Step title="Save changes">
    Click the save button or press Cmd+S (Mac) / Ctrl+S (Windows) to submit the form. The page reflects the dirty state with a save indicator while there are unsaved changes.
  </Step>
</Steps>

## Related

<Columns cols={2}>
  <Card title="IT Service Management" icon="headset" href="/it/overview">
    IT Service Management overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/it.tsx
  * src/cores/it/pages/ITSettingsPage.tsx
  * src/cores/it/hooks/useITModuleSettings.ts
</Accordion>