How to Install a NinjaTrader 8 Indicator: Import, Update and Remove
Every indicator and add-on for NinjaTrader 8 installs the same way, through the platform’s own import tool — no files to move, no code to touch. Here is the two-minute version, the folder NinjaTrader keeps indicators in, what its error messages actually mean, and the one rule for updating that nobody tells you.
Before you start
- NinjaTrader 8, any version, on Windows. NinjaTrader 8 runs on Windows only, so its add-ons do too. There is no separate version for NinjaTrader’s web platform.
- Keep the download zipped. NinjaTrader imports the .zip itself. If Windows or your browser unzipped it for you, download it again; the importer will not accept a folder or the loose files inside.
- Nothing to type. Free tools have no licence key. Paid ones license to your NinjaTrader account automatically — explained below.
How to import an indicator or add-on
- Open the NinjaTrader 8 Control Center.
- Click Tools → Import → NinjaScript Add-On.
- In the file browser, select the .zip you downloaded and click Open.
- If the file contains an add-on — something that runs on its own rather than only on a chart — NinjaTrader asks you to confirm, in its own words: “This NinjaScript Archive File contains NinjaScript add ons which are run automatically. Please ensure this archive is from a trusted source before importing.” Confirm. Indicators do not trigger this prompt.
- Wait for the confirmation: “NinjaTrader successfully imported all scripts contained in the NinjaScript Archive File.” That is the whole installation.
If instead you see a message that starts “Import failed”, nothing has been installed — skip to what it means. If NinjaTrader asks “Would you like to replace the existing file?”, you already have a version of this tool: read the restart rule before answering.
How to add it to a chart, and keep it there
- Right-click the chart and choose Indicators… (for chart add-ons such as candle stylers or watermarks the entry may sit in the chart’s right-click menu or the toolbar instead; the product page says which).
- Find the tool in the list on the left, double-click it, set anything you want to change on the right, and click OK.
- To keep it across restarts, save the workspace: File → Save Workspace. NinjaTrader also asks “Do you want to save workspace ‘…’?” when you close; answering yes does the same thing.
An indicator that “disappeared after restart” is almost always still installed — the workspace was closed without saving, so the chart came back without it. Add it again and save the workspace this time. Chart templates work too: right-click the chart, save the template, and the indicator comes with it onto any chart you apply it to.
Where NinjaTrader keeps indicators
You never need this folder for a normal install, but people search for it, so here it is. NinjaTrader keeps every custom script under your Documents folder:
Documents\NinjaTrader 8\bin\Custom\Indicators\ for indicators, with \AddOns\, \Strategies\ and \DrawingTools\ beside it for the other kinds.
Two things worth knowing about it. Files NinjaTrader ships itself start with an @ — @VWAP.cs, @BarTimer.cs — and anything without the @ was installed by you or a vendor, which is a quick way to see what is on a machine. And if that Documents folder lives inside OneDrive, imports can end in an error about a path being denied and NinjaTrader closing: OneDrive marks folders read-only while it syncs, and NinjaTrader deletes a temporary import folder as its last step. Pausing OneDrive during an import avoids it; moving the NinjaTrader 8 folder out of OneDrive ends it for good. NinjaTrader’s own advice, shown in its settings, is to keep your Documents folder on a local directory.
How to update an indicator: the restart rule
Installing a new version over an old one is where most installation trouble comes from, and the cause is simple: after you remove a tool, NinjaTrader keeps the old code loaded in memory until it is restarted. Import the new version without restarting and the import can succeed while the old version keeps running — the “fix does not work” report that every vendor gets. The rule:
- Remove the old version: Tools → Remove NinjaScript Assembly, pick it, confirm.
- Close NinjaTrader and start it again, even though nothing asked you to.
- Import the new .zip as above.
- Add it to the chart again, since the removal took it off.
If you answered yes to “Would you like to replace the existing file?” instead of removing first, the import usually works — but if the new version behaves like the old one, do the four steps above. It takes a minute and settles it.
How to remove an indicator
Removing it from a chart and removing it from NinjaTrader are different things.
- From one chart: right-click the chart → Indicators…, select it in the right-hand list, click Remove, then OK.
- From NinjaTrader: Tools → Remove NinjaScript Assembly, pick it, confirm, then restart. This is the one to use before installing an update.
If removal refuses with “Remove failed. You have custom NinjaScript files on your PC that have programming errors. These errors must be resolved before removing a NinjaScript assembly”, some other script on the machine does not compile, and NinjaTrader will not touch its assemblies until that is fixed — see the compile section.
What “Import failed” means
NinjaTrader’s message is long and, read carefully, lists the three causes: “Import failed. The NinjaScript Archive File may contain duplicate method names that already exist on your PC, modify a method signature that other scripts were dependent on, or be missing a required file on either your PC or in the import archive.”
- Duplicate method names is by far the most common, and it usually means an older copy of the same tool is still installed — or that the vendor renamed the product and the old name is still on your machine. Remove the old one (Tools → Remove NinjaScript Assembly), restart NinjaTrader, import again.
- A modified method signature means another script on your PC depends on something this import changes. Rare for indicators; remove the dependent script first, or ask the vendor.
- A missing required file means the archive is incomplete — re-download it — or it needs something not on your machine, which the vendor has to supply.
Two non-causes worth ruling out first: you selected a folder or an extracted file rather than the .zip, or the download was cut short. Both look like a failed import and are fixed by downloading the .zip again.
Indicator not showing in the list
After a successful import the tool is in the Indicators list immediately; if it is not, one of these is true:
- You are looking in the wrong list. Add-ons are not indicators. A candle styler, a watermark, a notes panel or a HUD lives where its product page says — usually the chart’s right-click menu or toolbar — not under Indicators…
- Something on the machine does not compile. NinjaTrader compiles all custom scripts together, so one broken script hides everything imported after it. Open Control Center → New → NinjaScript Editor, press F5 to compile, and read the errors at the bottom: the file named there is the culprit, and it is rarely the one you just installed. Fix or remove it and compile again.
- The import actually failed and the message was dismissed. Check Control Center → Log for the entry, then read what it means.
Installing a .cs source file by hand
Occasionally a tool arrives as a single .cs file — a custom build, or source you have been given — instead of a .zip. Copy it into Documents\NinjaTrader 8\bin\Custom\Indicators\ (or \AddOns\, \Strategies\), open Control Center → New → NinjaScript Editor, press F5, and watch for the compile to finish without errors. The tool then appears in the list like any other. This is the only route that involves the folder, and it is the only one that can produce compile errors of its own; if it does, they belong to whoever wrote the file.
Paid products and licensing
A paid product installs exactly like a free one. What differs is that it is licensed through NinjaTrader’s own vendor licensing, which ties the licence to your NinjaTrader account and starts automatically the first time the tool loads on a chart. There is no key to paste and no licence server of ours to reach. If the tool says it is unlicensed, the account you are logged into NinjaTrader with is not the one the licence was created for — email support with the account name and it is moved.
Common questions
How do I install an indicator in NinjaTrader 8?
Download the .zip and leave it zipped. In the Control Center choose Tools, Import, NinjaScript Add-On, select the file and click Open. NinjaTrader confirms with the message that it successfully imported all scripts contained in the NinjaScript Archive File. Then right-click a chart, choose Indicators, and add it.
Where is the NinjaTrader 8 indicators folder?
Documents, NinjaTrader 8, bin, Custom, Indicators. Add-ons, strategies and drawing tools have sibling folders next to it. You never need the folder for a normal .zip install; it matters only when installing a .cs source file by hand or when checking what is on a machine, where files NinjaTrader ships itself start with an at sign.
Why does NinjaTrader say import failed, duplicate method names?
An older copy of the same tool, or the same tool under a previous name, is still installed. Go to Tools, Remove NinjaScript Assembly, remove it, close and restart NinjaTrader, then import again. The restart matters: without it the old code stays loaded and the new import can lose to it.
How do I update an indicator to a new version?
Remove the old version with Tools, Remove NinjaScript Assembly, close and restart NinjaTrader even though nothing asks you to, import the new .zip, and add the tool to your chart again. Importing over the old version without restarting can leave the old code running, which is why an update sometimes seems not to work.
How do I remove an indicator from NinjaTrader 8?
From a chart: right-click, Indicators, select it in the right-hand list, Remove, OK. From the platform entirely: Tools, Remove NinjaScript Assembly, pick it and confirm, then restart. If removal fails because custom NinjaScript files have programming errors, another script on the machine does not compile and must be fixed or removed first.
The indicator imported but is not in the list. Why?
Either it is an add-on rather than an indicator and lives in the chart's right-click menu or toolbar, or another script on the machine fails to compile and hides everything imported after it. Open New, NinjaScript Editor, press F5, and the error at the bottom names the broken file, which is rarely the one you installed.
Do paid indicators need a licence key?
No. Paid products here are licensed through NinjaTrader's own vendor licensing, tied to your NinjaTrader account, and the licence starts automatically the first time the tool loads. Nothing is typed and no third-party licence server is involved. If a tool reports itself unlicensed, you are logged into a different NinjaTrader account from the one the licence was made for.
Related guides
- Why is my NinjaTrader chart lagging? — if the platform feels slow after installing things, this is the diagnosis.
- How to enable Chart Trader — the panel that order tools need before they will run.
- How to change candlestick colors — chart templates, and how a saved look carries indicators with it.
The honest part
Installing a NinjaTrader indicator is genuinely a two-minute job, and almost every problem people have with it is one of three things: the file was unzipped, an old version was still installed, or NinjaTrader was not restarted after removing it. This page exists so that you never email support about any of those — but if you do get stuck, [email protected] answers with your NinjaTrader version number and a description of what you see.