importScript( '{{{1}}}' ); // Backlink: [[{{{1}}}]]
![]() | This template should always be substituted (i.e., use {{subst:Install user script}} ). Any accidental transclusions will be automatically substituted by a bot. |
This template is used to install user scripts that reside on the English Wikipedia. It is to be used primarily on Special:MyPage/common.js or Special:MyPage/skin.js. It adds the necessary importScript
line along with a backlink.
In order to install a user script for your Wikipedia account, add the following line to Special:MyPage/common.js or Special:MyPage/skin.js:
{{subst:iusc|script_path}}
script_path
with the full .js page name of the user script to be installed.subst:
), or else it won't work.{{subst:iusc|User:TheDJ/sharebox.js}}
importScript( 'User:TheDJ/sharebox.js' ); // Backlink: [[User:TheDJ/sharebox.js]]
There is some confusion about whether or not importScript() is deprecated. The answer is that it is not deprecated.
In 2015, importScript() was deprecated for one week, and then the action was reversed. In 2022, a bug causing importScript() to not work for mobile users was fixed. As of 2022, the latest statement by software engineers on the deprecation is phab:T27845#8135189, which states For local imports, call importScript(). This is not, and never was, deprecated. For cross-wiki and other less trivial use cases, call mw.loader.load().
In conclusion, importScript() is not deprecated, and editors should feel free to use it. It does not need to be systematically replaced by mw.loader.load(), and {{iusc}} does not need to be replaced with {{lusc}}.
{{Install user script}} uses importScript(), and {{Load user script}} uses mw.loader.load().
importScript():
importScript('c:User:YourName/test.js');
mw.loader.load():
mw.loader.load()
method.© MMXXIII Rich X Search. We shall prevail. All rights reserved. Rich X Search