System Settings
System settings shape how the dashboard behaves for every user. Proper configuration keeps reports, periods, and languages aligned across the program. This guide explains the scope of settings, how to edit them safely, and how to coordinate changes across teams.
Purpose of system settings
- Define program-wide preferences such as language, time zone, and reporting cycles.
- Influence modules throughout the dashboard, including data entry, invoices, and analytics.
- Centralize controls so administrators can adjust behavior without deploying new code.
Categories you will encounter
- General preferences – Default landing pages, date formats, and time zones.
- Reporting cycles – Fiscal year start, period availability, and deadline configurations.
- Notification options – Rules governing who receives alerts and what channels are used.
- Security policies – Session timeouts, password strength requirements, and multi-factor authentication prompts.
- Data retention – Duration for keeping historical records, logs, and attachments.
- Localization – Languages, currency symbols, and regional formatting for numbers.
Access control
- Restrict edit access to trusted administrators. Because settings affect every user, a small group should manage them.
- Provide read-only access to program leads who need visibility without the ability to change values.
- Record each change automatically in the audit log, including the user, timestamp, and previous value.
Editing a setting
Navigate to Administration and select Settings. The page groups options by category with search and filter tools.
Scroll or use the search bar to find the setting you plan to adjust. Each entry includes a description explaining its impact.
Click the edit icon to open the inline form or modal. Adjust the value and review any validation hints that appear.
Save the change. The system may prompt you to reload the page or notify affected users, depending on the setting.
Coordinating changes
- Plan ahead – Notify stakeholders before changing fiscal year start dates or reporting cycles so they can adjust schedules.
- Communicate clearly – Send summary emails or post intranet updates describing what changed and why.
- Test first – Use a staging environment to evaluate the impact of major adjustments, especially for period definitions.
- Document approvals – Record who approved the change and the reasoning to support audits.
Common setting areas in detail
General preferences
- Control the default landing page after login.
- Define date and time formats that match national standards.
- Set the currency symbol displayed across financial reports.
Notification options
- Configure email or in-app alerts for data entry deadlines, quality visits, and invoice readiness.
- Assign notification recipients by role, partner, or facility group.
- Set escalation rules when issues remain unresolved after a specific time.
Security policies
- Adjust session timeout duration to balance usability and security.
- Require strong passwords by defining minimum length and complexity.
- Enable multi-factor authentication prompts for high-risk roles.
Data retention
- Specify how long audit logs, invoices, and uploaded documents remain accessible.
- Align retention periods with national regulations and donor requirements.
- Plan for secure archival or deletion once the retention period ends.
Reporting cycles
- Define the fiscal year start month to align analytics with budget planning.
- Configure grace periods for data entry and quality score submission.
- Control whether the system uses calendar periods, fiscal periods, or both.
Localization
- Enable languages relevant to your users and set the default language.
- Configure decimal separators and thousand delimiters for consistency.
- Provide localized labels for datasets, modules, and notification templates.
Best practices
- Bundle related changes together. For example, update the fiscal year start and adjust invoice reporting windows during the same maintenance window.
- Keep a shared change log accessible to all administrators so they can review what happened and when.
- Train new administrators using sandbox environments before granting production access.
- Schedule regular reviews to ensure settings still match program policy.
Troubleshooting
- Setting appears locked – You may lack permission or the setting is controlled by a higher-level policy. Contact the system owner for clarification.
- Change not visible to users – Ask users to refresh or log out and back in. Some settings apply only after a new session starts.
- Unexpected behavior after update – Revert to the previous value using the audit log reference, then investigate dependencies.
- Conflicting configurations – Review related modules to ensure another setting is not overriding your change.
Frequently asked questions
How often should settings be reviewed? Schedule quarterly reviews, with additional checks before major reporting cycles or donor reviews.
Can we export current settings? Yes. Use the export function to produce a snapshot, then store it in your configuration archive.
Who approves changes? Follow your governance policy. Typically, a small committee reviews and approves major adjustments, especially those impacting payments or security.
Do settings affect historical data? Some settings, such as localization or fiscal year definitions, may change how historical data is presented. Always note when the change occurred to explain discrepancies.
How do we test? Use staging environments populated with realistic sample data. Run through key workflows—data entry, invoice generation, and report downloads—to confirm nothing breaks.
Key takeaways
- System settings influence every workspace, so treat changes with care.
- Coordinate with stakeholders and document approvals before applying updates.
- Use staging environments for testing and keep backups in case you need to revert.
- Review settings regularly to ensure alignment with current policies.
- Maintain clear communication with end users when significant changes occur.
Careful management of system settings keeps the dashboard predictable and reliable.