---
title: "Organization Settings"
description: "How to configure organization-level billing toggles and session timeout — enabling OPD, IPD, Pharmacy, and Doctor Payment ledger accounts."
date: 2026-07-19
lastModified: 2026-07-26
category: "admin"
author: "Dr. Umesh Bilagi"
beta: false
---

## Overview

Organization Settings control billing channel activation and session security. Accessible only by the **admin** role.

**Sidebar → Admin → Organization → Settings** (`/admin/admin/org/setting/{organizationId}`)

This page is not available on the Free plan.

## Settings

### Idle Session Timeout

| Field | Type | Default | Range |
|-------|------|---------|-------|
| **Idle Session Timeout (minutes)** | Number | 60 | 15–1440 |

Minutes of user inactivity before automatic logout. The value is clamped server-side — entering a number below 15 or above 1440 is adjusted to the nearest limit.

### Billing Toggles

Four toggles control which billing channels are active. Each toggle, when enabled, creates a ledger account in the `patient` table with the corresponding account type. When disabled, it sets the account to inactive — the ledger still exists but cannot be used for new transactions.

| Toggle | Account Type | What It Enables |
|--------|-------------|-----------------|
| **Activate OPD Billing** | OPD | Outpatient billing for OPD encounters and services |
| **Activate pharmacy Billing** | PHARMACY | Pharmacy purchase and invoice vouchers (PURCHASE_P, INVOICE_P). The Pharmacist role depends on this being active. |
| **Activate IPD Billing** | IPD | Inpatient billing for IPD admissions and bed charges |
| **Activate Doctor Billing** | DOCTOR_PAYMENT | Journal entries for doctor payment tracking. Not needed for routine clinical use — only if you track doctor payments through the accounts system. |

Each toggle checks whether an account of that type already exists for the organization. If it does, the toggle reflects its current active state and switching it updates `isActive`. If no account exists, one is created automatically when toggled on.

Disabling a billing channel does not affect historical transactions — only new ones are blocked.

## Page Layout

The settings form is the top section of the page. Below it are two additional components:

| Component | Purpose |
|-----------|---------|
| **Facebook Integration** | Meta Business Suite connection for WhatsApp and Instagram messaging |
| **NHCX Participant** | PMJAY/NHCX participant configuration (development environments only — production NHCX setup is handled separately under Admin → Organization) |

## FAQ

**Q: Can I turn off a billing channel that has existing transactions?**
A: Yes. Disabling a toggle sets the account to inactive, which blocks new transactions but preserves all historical data.

**Q: Where do I configure print settings and letterhead?**
A: Print settings are on a separate page. See [Printing and Setting Up Letter Pad Header](/docs/printing-and-set-up-of-letter-pad-header).

**Q: Where do I set the organization name, address, GST, etc.?**
A: These are set when the organization is created and can be edited through the organization edit flow, not on this Settings page.

**Q: What does the Doctor Billing toggle do?**
A: It creates a DOCTOR_PAYMENT ledger account for tracking payments to doctors through journal entries. This is separate from creating doctor profiles (see [Creating Doctors](/docs/creating-doctors)). Most organizations only need OPD, IPD, and Pharmacy billing.

**Q: Is the NHCX Participant section for production use?**
A: No. The NHCX Participant component on this page is for development environments. Production NHCX/PMJAY setup is configured separately.