Feature Flags & Module Gates
Some Resgrid modules are behind feature flags so they can be rolled out gradually. On the hosted service Resgrid staff switch them on; on a self-hosted installation the operator does it with the tools console. Flags are stored in the database (FeatureFlags, FeatureFlagOverrides, FeatureFlagTargetingRules, FeatureFlagPrerequisites), cached, and evaluated per department: a department override wins over a percentage rollout and targeting rules, which win over the global default.
Managing flags (self-hosted)
# list flags and what a department resolves to
dotnet Resgrid.Console.dll --FeatureFlags --DepartmentId=1
# turn a flag on for one department (department override)
dotnet Resgrid.Console.dll --FeatureFlags --Key=Records.System --DepartmentId=1 --On
# turn a flag on globally (default for every department without an override)
dotnet Resgrid.Console.dll --FeatureFlags --Key=Checklists.System --On
# remove an override, staged rollout, list keys the code gates on
dotnet Resgrid.Console.dll --FeatureFlags --Key=Chat.System --DepartmentId=1 --Clear
dotnet Resgrid.Console.dll --FeatureFlags --Key=Chat.System --Rollout=25
dotnet Resgrid.Console.dll --FeatureFlags --Keys
Writes go through the feature-toggle service, so caches are invalidated and an audit event is written; web, API and workers pick up the change on their next read. FeatureFlagsConfig.FeatureFlagsEnabled=false turns the whole subsystem off (every flag reads as disabled).
Flags
| Key | Gates | Depends on | Seeded |
|---|---|---|---|
Chat.System | Realtime chat, incident channels, Assistant conversation, moderation (web + apps). Free for all plans. | — | M0108 |
Chatbot.TwilioTextIntegration | Routes inbound SMS through the Assistant pipeline instead of the legacy text commands. | — | — |
Dispatch.RunCards | Run cards, station-based / closest-unit selection, move-ups, alarm levels. | — | M0116 |
Checklists.System | Checklists module (free). | — | M0189 (off) |
Maintenance.WorkOrders | Work orders and preventive maintenance. Also needs the Readiness Pro add-on and the Maintenance module switch. | — | M0189 (off) |
Records.System | The Records module; replaces Logs in the sidebar. A department must also activate Records. | — | M0152 (off) |
Records.Field.Responder / .Unit / .IncidentCommand / .Dispatch | Field Records surfaces in each app. | Records.System | M0152 |
Records.Prevention.Occupancy | Occupancies and the pre-plan crosswalk. | Records.System | M0186 |
Records.Prevention.Inspections | Inspection programs, code sets, inspections, violations. | Records.Prevention.Occupancy | M0186 |
Records.Prevention.Hydrants | Hydrants and water sources. | Records.System | M0186 |
Records.Prevention.Permits | Permits and plan review. | Records.Prevention.Occupancy | M0186 |
Records.Prevention.Crr | Community risk reduction activities, smoke / CO alarm counts and alarm requests (M0284). | Records.System | M0186 |
Records.Investigations | Investigation cases. | Records.System | M0186 |
Records.QualityReview | Quality review rubrics and sampling. | Records.System | M0186 |
Records.Analytics | Records analytics dashboards. | Records.System | M0187 |
Search.Unified | Search: the Search page and search results in the top-bar box (the Go to shortcuts work without it). The installation must also run the search host (SearchConfig.Enabled). | — | M0208 (off) |
Security.DepartmentProtectedDataEnrollment | Platform-wide admission gate for new Advanced Data Protection enrollments (operator-managed; never affects departments already enrolled). | — | M0126 |
Business.Operations | Master switch for every paid Business Ops surface; the purchase itself is the Business Ops add-on. | — | M0211 (off) |
Invoicing.CustomerInvoicing | Invoicing: billing profiles, rate cards, invoices, payments, aging. Also needs the Business Operations module switch and the add-on. | Business.Operations | M0211 (off) |
Payments.StripeConnect | Operator-only per-region kill switch for online payment collection (on in the US cluster, off in the EU cluster at launch). Departments cannot override it. | — | M0212 (off, permanent) |
Invoicing.OnlinePayments | Customers pay invoices through the department's own Stripe account. | Invoicing.CustomerInvoicing, Payments.StripeConnect | M0212 (off) |
Operations.Deployments | Deployment Finance (Workforce & Business Ops → Deployments): deployments, rosters, daily time reports, expenses, files, external orders (which also need Records.System). Free — no add-on. Read-only deployment reports need only Records.System. | — | M0219 (off) |
Invoicing.ContractorBilling | Rate schedules, contracts, bids, the deployment wizard and invoice generation from time reports. | Business.Operations | M0219 (off) |
CostRecovery.CalOesMars | Cal OES MARS cost recovery. | Business.Operations | M0219 (off) |
Workforce.InternalCosting | Workforce compensation, work entries, resource costing and cost runs. | Business.Operations | M0224 (off) |
Compliance.CaliforniaPayDataReporting | California CRD pay data report wizard and demographic self-identification; the department's Advanced Data Protection state must also be Enabled. | Business.Operations | M0224 (off) |
Onboarding.MigrationWizard | Import & Migration: the self-service import of configuration, people and apparatus. Master switch; department administrators only. | — | M0277 (off) |
Onboarding.OperationsData | Import & Migration wave 2B: dispatch configuration, shifts, calendar, geography, contacts and Records prevention data. Not used by the current release. | Onboarding.MigrationWizard | M0277 (off) |
Onboarding.ReadinessData | Import & Migration wave 2C: inventory, checklists, maintenance plans, open work orders and Business Ops profiles. Not used by the current release. | Onboarding.MigrationWizard | M0277 (off) |
Onboarding.OperationalHistory | Import & Migration phase 3: closed calls, training results and certification history. Not used by the current release. | Onboarding.MigrationWizard | M0277 (off) |
Onboarding.HistoricalRecords | Import & Migration phase 3R: third-party incident history into Records. Not used by the current release. | Onboarding.MigrationWizard, Records.System | M0277 (off) |
Onboarding.VendorPacks | Import & Migration phase 3B: sample-validated vendor export packs. Not used by the current release. | Onboarding.MigrationWizard | M0277 (off) |
Onboarding.DepartmentPackage | Import & Migration phase 4: Resgrid department package export, cluster moves and configuration cloning. Not used by the current release. | Onboarding.MigrationWizard | M0277 (off) |
Onboarding.ManagedMigration | Operator-only: offers the Operate support access level (Resgrid staff run an import with two-person control) and the Please do the migration for us request, for a department with an agreed managed migration. Never enabled globally; set per department. | Onboarding.MigrationWizard | M0277 (off, permanent) |
Other gates
Besides flags, a page can be hidden by:
| Gate | Where |
|---|---|
| Module switches (Messaging, Mapping, Shifts, Logs/Records, Reports, Documents, Calendar, Notes, Training, Inventory, Checklists, Maintenance, Business Operations) | Department Settings → Module Settings (DepartmentModuleSettings) |
| Plan and add-ons (PTT, ADP, Readiness Pro, Business Ops, Enterprise SSO) | Subscription & Billing; entitlement checked against the billing API (SubscriptionsService, ReadinessAccessService, BusinessOperationsAccessService) |
| Permissions | Security & Permissions |
| Records activation | Records → Activate (RmsDepartmentCutover) |
| Installation config | e.g. NERIS submission switched off system-wide, external connectors off, tracker gateway disabled |
Environments
A flag can be restricted to an environment (SystemBehaviorConfig.Environment: Dev, QA, Staging, Production); a flag pinned to another environment evaluates as its off value.