How to Install MT5 Custom Indicators: Step-by-Step

Last Updated: October 23, 2026

Quick Summary

To install MT5 custom indicators, copy your indicator file (.mq5 or .ex5) to the Indicators folder in your MT5 data directory, compile it if it’s a .mq5 file, then refresh the Navigator and attach it to a chart. On Windows, the folder is typically C:\Users\[YourUsername]\AppData\Roaming\MetaQuotes\Terminal\[TerminalID]\MQL5\Indicators, while on Mac it’s ~/Library/Application Support/MetaTrader 5/MQL5/Indicators.

  • MetaTrader 5 only recognizes .mq5 source files and .ex5 compiled files in the official Indicators folder.
  • Source code .mq5 files must be compiled via MetaEditor before MetaTrader 5 can use them, while .ex5 files are ready to use immediately.
  • After copying a file to the Indicators folder, right-click the Indicators folder in Navigator and select Refresh to make the indicator appear.
  • Common installation failures include using the wrong folder location, forgetting to compile .mq5 files, and not adjusting input parameters when the indicator shows no data.
  • Mobile MT5 on iOS and Android does not support custom indicators at all, only built-in ones.

Table of Contents

What You Need Before Installing MT5 Custom Indicators

To install MT5 custom indicators on MetaTrader 5 requires three things: access to the MT5 platform, a custom indicator file (.mq5 source or .ex5 compiled), and knowledge of where your MT5 data folder lives.

Skipping this preparation is where things go wrong; understanding it first saves hours of troubleshooting.

What separates a smooth installation from a frustrating one is knowing your folder layout and file type.

Verify your indicator is compatible with your MT5 version and broker setup.

Understanding MT5 Custom Indicator File Types and Locations

MetaTrader 5 uses two indicator file types, and understanding the difference prevents confusion during installation.

Trader pointing to the MT5 Navigator panel to install MT5 custom indicators in the correct folder structure.
Trader pointing to the MT5 Navigator panel to install MT5 custom indicators in the correct folder structure.

Where Indicator Files Live on Your Computer

Your MT5 data folder contains everything MetaTrader 5 needs to run. The structure is the same on Windows and Mac, though the path differs.

On Windows, the data folder typically lives here:

  • C:\Users\[YourUsername]\AppData\Roaming\MetaQuotes\Terminal\[TerminalID]\MQL5\Indicators

On Mac, the path is:

  • ~/Library/Application Support/MetaTrader 5/MQL5/Indicators

The Indicators folder is the destination for every indicator file you install. If you can’t find it, you haven’t accessed your data folder yet, and locating it is the first real step.

Some traders store indicators elsewhere and expect them to appear in MetaTrader 5. They won’t; the platform only reads from the official Indicators folder.

File Types: .mq5 Source Code vs. .ex5 Compiled Files

Source code files (.mq5) are human-readable text files containing the indicator’s logic in MQL5. You can open them in a text editor, but MetaTrader 5 can’t use source code directly, it needs to compile it first.

Compiled files (.ex5) are the finished product. MetaTrader 5 reads and executes them directly; they’re smaller, faster, and ready to use. Most traders download .ex5 files to skip compilation entirely.

The practical difference: a .mq5 file must be compiled before MetaTrader 5 recognizes it, while a .ex5 file just needs copying to the Indicators folder. Beginners should prefer .ex5; developers who want to modify indicators need .mq5.

How to Add an Indicator to an MT5 Chart: Windows Installation

To install MT5 custom indicators on Windows takes four steps. Follow them in order and you’ll have your indicator running within minutes.

https://www.youtube.com/watch?v=1ub6CTK3BCk

Step 1: Download or Locate Your Indicator File

Get the indicator file from a source such as the MQL5 Marketplace, broker-provided libraries, third-party trading sites, or trading communities. Download it somewhere easy to find, like your Downloads folder, and check the extension: you want .mq5 or .ex5. If a site bundles multiple files, extract the archive so you end up with a single .mq5 or .ex5 file.

Step 2: Copy the File to the Indicators Folder

Open Windows File Explorer and navigate to your MT5 data folder:

C:\Users\[YourUsername]\AppData\Roaming\MetaQuotes\Terminal\[TerminalID]\MQL5\Indicators

The AppData folder is hidden by default; click the View tab and check “Hidden items” to see it. Copy your indicator file directly into the Indicators folder, not a subfolder or other location, or MetaTrader 5 won’t find it.

Step 3: Compile Source Code (If Needed)

If you copied a .mq5 file, you need to compile it. If you copied a .ex5 file, skip to Step 4.

To compile a .mq5 file on Windows:

  1. Open MetaTrader 5
  2. Go to Tools menu → MetaEditor (or press Ctrl+Shift+E)
  3. In MetaEditor, go to File → Open and select your .mq5 file from the Indicators folder
  4. Press Ctrl+Shift+F9 or go to Compile menu → Compile
  5. Watch the Compile tab at the bottom, you should see “0 error(s), 0 warning(s)”

If compilation succeeds, MetaTrader 5 automatically creates a .ex5 file. You now have both the source code and the compiled version in your Indicators folder.

If you see errors, the code has issues. Common errors include missing libraries or syntax problems. Check the error message, it usually tells you exactly what’s wrong. Many indicators require specific libraries or versions of MetaTrader 5. If errors persist, verify the indicator is compatible with your MT5 version.

Step 4: Refresh the Navigator and Apply to Your Chart

MetaTrader 5 doesn’t automatically detect new indicators, so refresh the Navigator:

  1. Go to View menu → Navigator (or press Ctrl+N)
  2. Right-click the Indicators folder
  3. Select “Refresh” or press F5
  4. Your new indicator should appear in the list

To apply it to a chart:

  1. Open a chart for any trading pair and timeframe
  2. Find your indicator under the Indicators folder in the Navigator
  3. Double-click it, or drag it onto the chart
  4. Adjust settings in the input parameters window if needed
  5. Click OK

The indicator now displays on the chart, either as a separate window below price or as an overlay, depending on how it’s coded.

Install MT5 Indicators on Mac: Platform-Specific Steps

Mac users follow the same concept, get the file to the right folder, compile if needed, and refresh, but paths and menus differ.

On Mac, the MT5 data folder lives at:

Signup Now →

~/Library/Application Support/MetaTrader 5/MQL5/Indicators

Open Finder, press Cmd+Shift+G, paste the path, and press Enter. Then:

  1. Copy your indicator file (.mq5 or .ex5) into this Indicators folder
  2. If it’s a .mq5 file, open MetaTrader 5 and compile it via Tools → MetaEditor
  3. In MetaEditor, open the file and press Cmd+Shift+F9 to compile
  4. Return to MetaTrader 5 and refresh the Navigator (Cmd+N, right-click Indicators, select Refresh)
  5. Double-click your indicator to attach it to a chart

If you can’t copy files to the Indicators folder, right-click it, select Get Info, and adjust permissions to allow your user account to write files. Note that MT5 on Mac doesn’t support all Windows features, so some indicators may behave differently or require Windows-specific code; check the documentation for Mac compatibility notes.

MT5 Indicator Not Showing: Troubleshooting by Symptom

Indicators fail to show for specific, fixable reasons. Match your symptom to the solution below.

Indicator Doesn’t Appear in Navigator After Installation

You copied the file, refreshed the Navigator, and it’s still not there.

First, verify the file is in the right folder by navigating to your Indicators folder manually. If it’s not, move it there. If it is, check the extension: MetaTrader 5 only recognizes .mq5 and .ex5, so rename a .txt or extensionless file to .ex5 and try again.

Still not showing? Restart MetaTrader 5 completely, since the Navigator cache sometimes doesn’t update until you do.

Indicator Attaches to Chart but Displays No Data

The indicator appears in the Navigator and attaches to a chart, but nothing shows up.

This usually means unconfigured input parameters. Right-click the indicator on the chart, select “Edit” or “Properties,” and adjust settings like Symbol, Period (number of candles), Price type (close, open, high, low), and Calculation method (SMA, EMA, etc.) to match your chart.

If parameters don’t fix it, check broker compatibility, since some indicators require specific data feeds or account types. Another common cause is insufficient historical data: some indicators need 100+ candles, so scroll left on the chart or change the timeframe to load more.

Compilation Errors Prevent Indicator from Running

You’re compiling a .mq5 file and MetaTrader 5 shows errors in the Compile tab.

Read the error message, which gives the line number and problem. Common errors include “Unknown identifier” (a referenced library or function doesn’t exist), “Type mismatch” (a variable used as the wrong data type), and “Syntax error” (a typo or missing punctuation).

If the error mentions a missing library, check the indicator’s documentation for required libraries and install them to the Libraries folder next to the Indicators folder.

Mobile Platform Limitations and Security Considerations

MetaTrader 5 runs on iOS and Android, but mobile MT5 doesn’t support custom indicators at all, only built-in ones. A custom indicator installed on Windows or Mac won’t appear on your mobile app; this is a platform limitation, not an installation issue. For mobile trading, use built-in indicators or trade on desktop where your custom indicators are available.

Security matters when downloading indicators. Only use trusted sources: your broker’s official website, the MQL5 Marketplace, established trading communities with reputation systems, or developers you know. Avoid random websites or forums without reputation, since an indicator file can contain malicious code that steals credentials or executes unauthorized trades.

Security Practice Why It Matters Action
Download from official sources Reduces malware risk Use MQL5 Marketplace or broker sites
Verify source reputation Identifies trustworthy developers Check reviews and community feedback
Keep MT5 updated Patches security vulnerabilities Update to the latest MT5 version
Use strong broker passwords Protects account access Change password after installing indicators
Review code before compiling Catches suspicious instructions Read .mq5 source code if possible

Common Installation Mistakes to Avoid

Most installation problems stem from a few repeated mistakes.

Mistake 2: Not refreshing the Navigator. After copying a file, right-click the Indicators folder and select Refresh, or it won’t appear.

Mistake 3: Forgetting to compile .mq5 files. MetaTrader 5 can’t run source code directly, so always compile .mq5 files to .ex5 before use.

Mistake 4: Ignoring compilation errors. Errors mean the code won’t run; fix them or download a working version first.

Mistake 6: Not checking input parameters. An indicator showing nothing usually just needs the period, symbol, or calculation method adjusted.

Getting Started with Your Installed Indicators

Once your indicator runs on a chart, study it on historical data.

Read the documentation, which explains what the indicator measures, how to interpret its signals, recommended parameters for different trading styles, and known limitations.

Consider best MT5 indicators for beginners before diving into advanced setups; many traders jump to complex custom indicators when simpler ones suit their skill level better.

Test on a demo account for at least 50 trades before going live, so you can see real-market performance without risking money.

For traders ready to develop or optimize their own indicators, develop custom MT5 backtesting indicators provides a structured approach tailored to your strategy.


Installing MT5 custom indicators is a technical process you only need to learn once.

Frequently Asked Questions

How do I install a custom indicator in MT5?

Download the indicator file (.ex5 or .mq5), locate your MT5 data folder, navigate to MQL5/Indicators, and copy the file there. If it’s a .mq5 source file, compile it in MetaEditor first. Restart MT5 or refresh the Navigator, then find the indicator in your Navigator panel and drag it onto your chart. The entire process typically takes under five minutes.

Where do I put indicator files in MetaTrader 5?

On Windows, navigate to C:\Users\[YourUsername]\AppData\Roaming\MetaQuotes\Terminal\[TerminalID]\MQL5\Indicators. On Mac, go to /Users/[YourUsername]/Library/Application Support/MetaTrader 5/MQL5/Indicators. Copy your .ex5 or .mq5 files directly into this Indicators folder. Some brokers use custom terminal paths, so you can also access this location by clicking File > Open Data Folder in MT5 itself.

Why is my custom indicator not showing in MT5?

The most common causes are: the file is in the wrong folder, MT5 hasn’t been restarted since copying the file, or the indicator has compilation errors. First, verify the file is in the correct MQL5/Indicators folder. Then close and reopen MT5, or right-click the Indicators folder in Navigator and select Refresh. If you’re using a .mq5 source file, open MetaEditor, compile it to generate the .ex5 file, and check for error messages in the Errors tab.

Can I install custom indicators on MT5 mobile?

No. MT5 mobile applications (iOS and Android) do not support custom indicators. You can only use built-in technical indicators on mobile. To use custom indicators, you must trade on the desktop version of MT5 on Windows or Mac. Mobile platforms are designed for monitoring and manual trading, not loading custom automated systems.