Global Preferences

The Global preferences list is available only on the Open mSupply Central Server. They are preferences which apply to all Open mSupply sites.

Viewing Global Preferences🔗

To configure Global Preferences, go to the Global Preferences page under the Manage menu: goto: global preferences

You will be presented with the set of currently available Global Preferences:

facility list

Available Preferences🔗

Preference NameDescription
Allow tracking of stock by donorAdds a donor column to stock management screens. This allows you to track which donor a stock item is from.
Gender optionsThe gender options available for clinicians and patients. This defines the options shown in gender filters and which can be assigned to clinicians and patients.
Show contact tracingEnables the Contact Tracing feature for Patients
Custom TranslationsConfigure overrides for terms used throughout the application.
Sync records display thresholdThe number of sync records that will need to be pending before showing an indicator over the Sync menu item
Authorise purchase orders.Whether the purchase order process includes an authorisation step
Prevent transfers from this many months before initialisationWhen migrating older mSupply Desktop & mobile sites to Open mSupply this preference can prevent the generation of hundreds of locked inbound shipments. Open mSupply will not create Picked status inbound shipments corresponding to outbound shipments from supplier's stores that were picked this many months before the date the site was initialised. Similarly, it will not make customer requisitions for internal orders finalised this many months before initialisation.
Authorise goods receivedWhether the goods receiving process includes an authorisation step

Custom translations🔗

The Custom translations preference allows you to override specific terms used in the application. This is useful for localisation (or even localization!) or to adapt terminology to your specific context.

Use this feature carefully. It can lead to confusion if terms do not match our documentation, or if they are not consistent across the application.

You can search by any text you see within the application, or if you know the translation key, you can search by that as well:

custom translations search

Select the translation you want to change, and then enter the new text in the input field:

custom translations edit

Some translations include variables, which will be replaced with the appropriate values when they are used. You can move these variables around within the text, but ensure you keep them intact, so the messages continue to make sense. Variables are enclosed in double curly braces, like this: {{variable_name}}.

custom translations variable

For translations that include number-based variables, we also support pluralisation. If you select one of these translations, you will see both _one and _other translations are added. Make sure you provide the correct text for both cases:

custom translations pluralisation