TradingView says EURUSD. Your broker might list it as EURUSD.micro, i.EURUSD or EURUSDm. When the names differ, the EA looks for an instrument your account does not have and the trade fails.

Symbol mapping translates between the two. Your alerts, your symbol filters and your dashboard keep using the clean TradingView name, and only the order sent to the broker carries the broker's spelling.

Most people never need this

All the fields default to empty, and empty means no translation happens. If your trades are executing, you can skip this page.

Do you need it?#

Open MT5's Market Watch and compare how your broker spells the instruments you trade against the tickers in your TradingView alerts.

Names match exactly: nothing to do.
Names carry an extra prefix or suffix: set that affix.
Your broker uses a different name for the instrument: add a rename.

The usual sign you need it is a signal that reaches the EA and fails with the symbol unavailable, while the same alert works on a different account.

Where to set it#

Symbol mapping follows the same rule as every other EA setting, so where you set it depends on your Settings Source.

Your mode	Configure it in	The other source is
Dashboard	The dashboard, under EA Settings	Ignored
MetaTrader	The EA inputs, under Broker Symbol Mapping	Ignored

The two are never combined. A mapping assembled from both places would leave "why did it resolve to that symbol?" with two possible answers, so whichever source your mode names is the only one read.

The three fields#

Prefix is text added to the front. A broker listing i.EURUSD needs i.

Suffix is text added to the end. A broker listing EURUSD.micro needs .micro

Renamed instruments handle brokers that use a different name for an instrument, which affixes cannot express. Each rule maps one TradingView symbol to one broker symbol.

Most accounts need a suffix and nothing else.

Example: a broker that suffixes everything#

Your broker lists every instrument with .micro. Set the suffix to .micro and you are done.


Your alert	`LICENSE,buy,EURUSD,size_lots=0.1`
Sent to the broker	`EURUSD.micro`
Shown in Signal Logs	`EURUSD`

Example: a broker that renames one instrument#

The same broker suffixes with .r, and it also calls the Dow DJ30 rather than US30. That needs both a suffix and a rename:

Prefix:  (empty)
Suffix:  .r
Rename:  US30 -> DJ30.r

Alert says	Broker receives	Why
`EURUSD`	`EURUSD.r`	No rename matched, so the suffix applies
`US30`	`DJ30.r`	The rename matched

A rename replaces the whole symbol

A matching rename skips the prefix and suffix entirely. That is why the example above maps to DJ30.r and not DJ30. Write the broker's full symbol, exactly as MT5 spells it, including any affix.

Per-license mapping#

Each license can carry its own mapping, which is what you want when licenses run on different brokers.

A per-license mapping replaces the account one completely

Unlike other per-license settings, which override one field at a time, symbol mapping is replaced as a whole. Setting a rename on a license also discards the account's prefix and suffix for that license, including the fields you left blank.

If a license needs your account suffix plus one extra rename, enter both on that license.

The Licenses page marks any license with its own mapping, so you can see at a glance which ones are not following the account settings.

Checking it worked#

Send a test signal and look at Signal Logs. The clean TradingView name is what you will see there, because mapping happens at the broker boundary only. The proof it applied is that the trade executes.

If you want to watch the translation itself, set the EA's log level to LOG_DEBUG and the Experts tab will show a line like Symbol mapped EURUSD -> EURUSD.micro.

If it still fails#

Compare the resolved name against MT5's Market Watch character by character. A trailing space or a capital letter counts.
Confirm the instrument is visible in Market Watch. A symbol your broker offers but has not enabled on your account will not trade.
Check your Settings Source. A mapping saved in the dashboard does nothing while the EA is in MetaTrader mode, and vice versa.
For a rename, confirm the broker column contains the complete symbol including any affix.

Broker Symbol Mapping