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

# Facilities Settings

> Configure module-level settings for Facilities Management at /fm/settings, including work orders, inventory, maintenance, and asset management options.

This screen provides admin-level configuration for the Facilities Management module and is available at `/fm/settings`.

## Overview

The FM Settings page is wrapped in a `RequirePermission` for `fm.admin`, in addition to the parent `FMViewGuard`. It loads and saves FM module settings via `useFMModuleSettings`. A settings header displays the module icon, title ("Facilities Management Settings"), and description ("Configure module-level settings for your organization"), with a link to published documentation via `PUBLISHED_DOC_PATHS.moduleSettings.facilities`. A **Module Configuration** card contains `FMSettingsForm`, which is initialized from `transformSettingsForForm(settings)`. The form covers "work orders, inventory, maintenance scheduling, and asset management settings" (per the card description). A guided tour (`fmSettingsTour`) can be started via query parameter `?tour=fm-settings-tour` or the Help button.

## Who it's for

Requires permission `fm.admin` (inner `RequirePermission`), plus the outer `FMViewGuard` requiring `fm.dashboard.view`.

## Before you start

* Hold the `fm.admin` permission.
* Understand the impact of the settings being changed before saving.

## Steps

<Steps>
  <Step title="Open FM Settings">Navigate to `/fm/settings` via the FM admin menu.</Step>
  <Step title="Review current settings">The Module Configuration card displays current values from `useFMModuleSettings`.</Step>
  <Step title="Modify settings">Edit fields in `FMSettingsForm` as needed.</Step>
  <Step title="Save">Submit the form to call `upsert(values)` and persist the settings.</Step>
  <Step title="Start the guided tour">Add `?tour=fm-settings-tour` to the URL or click the Help button to walk through the settings page.</Step>
</Steps>

## Key concepts

* **Module settings** — organization-scoped configuration values for the FM core, stored and retrieved via `useFMModuleSettings`.
* **transformSettingsForForm** — utility that maps raw settings data to form-compatible initial values.

## Related

<Columns cols={2}>
  <Card title="Facilities & Inventory" icon="warehouse" href="/fm/overview">
    Facilities & Inventory core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</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/fm.tsx
  * src/cores/fm/pages/FMSettingsPage.tsx
</Accordion>