# Admin — Mark Foreigner / Mark Local Buttons Configuration The **Mark Foreigner** and **Mark Local** buttons let billing staff flag a patient's foreigner/local status directly from the billing screen, without leaving the bill in progress. This article explains where the buttons appear, the config key that controls their visibility, and how it relates to the separate patient-status feature. ## Where the buttons appear The Mark Foreigner / Mark Local button pair appears in the **Payment Details** panel on: - OPD Billing (`opd_bill.xhtml`, `opd_bill_ac.xhtml`) - OPD Orders (`opd_order.xhtml`) - OPD Billing for Cashier (`opd_pre_bill.xhtml`) - Channel Booking, by date and by month (`channel_booking_by_date.xhtml`, `channel_booking_by_month.xhtml`, `manage_booking_by_date.xhtml`, `manage_booking_by_month.xhtml`) - Clinic Sessions (`sessions.xhtml`) - Inward Service Bill (`inward_service_bill.xhtml`, `inward_service_bill_ac.xhtml`) Only one button shows at a time: **Mark Foreigner** while the current patient is Local, **Mark Local** once they've been marked a Foreigner. Clicking either updates the patient's status immediately and recalculates the bill (foreign-patient pricing, where configured, differs from local pricing). ## The config key | Key | Type | Default | Effect | |---|---|---|---| | `Show Mark Foreigner and Mark Local Buttons in Billing` | Boolean | `true` | Controls whether the Mark Foreigner / Mark Local buttons render on the screens listed above. | Toggle it via **Administration → Manage Institutions → Preferences → Application Options**: 1. Filter the **Key** column for `Show Mark Foreigner`. 2. Click the row's **Edit Option** button. 3. Toggle **Key Value** On/Off. 4. **Save**. The change takes effect immediately for new page loads — no separate "Reload Config" step is needed when editing through this dialog (Edit Option writes through the same controller that serves the buttons). ## Relationship to "Save the Patient with Patient Status" This key is intentionally **independent** of `Save the Patient with Patient Status`. That older key controls a different part of the UI — a read-only foreigner/local **badge** (and an editable toggle shown only while registering or editing a patient's own record). It does not offer a way to change status for a patient already selected mid-bill. Before this key existed, the Mark Foreigner / Mark Local buttons were tied to `Save the Patient with Patient Status` being **off** — so turning that option on for patient-status tracking silently removed the only in-billing way to flag a patient as a foreigner. See issue [#22311](https://github.com/hmislk/hmis/issues/22311). With the two keys separated, an institution can run both patient-status tracking **and** the quick Mark Foreigner / Mark Local buttons at the same time, or turn either off independently. ## Recommendation Leave the default (`true`) unless the billing workflow is fully driven by the newer patient-status badge/toggle and staff should not be able to change foreigner status from the billing screen directly.