Install ModernUI
This page explains how to place ModernUI into your MetaTrader 5 data folder so MetaEditor can find the include files and examples.
If you bought ModernUI from MQL5 Market, the ModernUI Launcher EA can fetch the package zip for you. Use Download from MQL5 Market first, then return here to finish the manual copy step.
What you will do
You will:
- Open the correct MT5 data folder.
- Copy
Include/ModernUIintoMQL5/Include/ModernUI. - Copy
Images/ModernUIintoMQL5/Images/ModernUIif you want the built-in atlas icons. - Copy examples into
MQL5/Experts/ModernUI/Examplesif they are not already there. - Restart MetaEditor.
- Compile a quick-start EA or supplied example.
Before you start
Make sure you have:
- MetaTrader 5 installed
- MetaEditor available
- the ModernUI package extracted
- access to your terminal’s
MQL5folder
Step 1 — Open the MT5 data folder
In MetaTrader 5:
File → Open Data Folder
Then open:
MQL5/
This is the folder MetaEditor uses for includes, experts, indicators, and scripts.
Do not guess the folder from Program Files. Use Open Data Folder from the terminal you actually use.
Step 2 — Copy the include folder
Copy this folder from the ModernUI package:
Include/ModernUI/
Into this MT5 folder:
MQL5/Include/ModernUI/
After copying, this file should exist:
MQL5/Include/ModernUI/ModernUI.mqh
Your EA include line should then work as:
#include <ModernUI\ModernUI.mqh>
Step 3 — Copy image assets
If your package includes built-in atlas icons, copy this folder from the ModernUI package:
Images/ModernUI/
Into this MT5 folder:
MQL5/Images/ModernUI/
After copying, these files should exist:
MQL5/Images/ModernUI/ModernUI_Icons_16.png
MQL5/Images/ModernUI/ModernUI_Icons_20.png
MQL5/Images/ModernUI/ModernUI_Icons_24.png
These images are optional. If they are missing, ModernUI falls back to canvas-drawn icons.
Step 4 — Copy examples
If your package includes examples, copy:
Experts/ModernUI/Examples/
Into:
MQL5/Experts/ModernUI/Examples/
The examples are optional for your own projects, but they are useful for confirming the installation.
Step 5 — Restart MetaEditor
Close and reopen MetaEditor after copying the files.
This helps MetaEditor refresh include paths and display the new files in the Navigator.
Step 6 — Compile a supplied example
Open one of the supplied .mq5 examples in MetaEditor and click Compile.
Good first checks are:
MQL5/Experts/ModernUI/Examples/BasicPanel.mq5
MQL5/Experts/ModernUI/Examples/FriendlyAliases_Demo.mq5
If the include path is correct, MetaEditor should find:
#include <ModernUI\ModernUI.mqh>
Expected result
A correct install should give you:
ModernUI.mqhunderMQL5/Include/ModernUI/- optional atlas PNGs under
MQL5/Images/ModernUI/ - examples under
MQL5/Experts/ModernUI/Examples/ - successful compilation of a supplied example
- a ModernUI panel visible when you attach the example EA to a chart
Common mistakes
Copying the wrong folder level
Wrong:
MQL5/Include/ModernUI/Include/ModernUI/ModernUI.mqh
Correct:
MQL5/Include/ModernUI/ModernUI.mqh
Using the wrong terminal data folder
If you have several MT5 installations, each one has its own data folder. Always use File → Open Data Folder from the exact terminal where you will run the EA.
Not restarting MetaEditor
If MetaEditor does not see the include files after copying, close and reopen MetaEditor.
Changing the include line
Use the package layout unless you intentionally install under a different vendor prefix.
Standard include:
#include <ModernUI\ModernUI.mqh>
Next step
Continue with Quick Start to compile a minimal ModernUI Expert Advisor.