Template:Install user script/doc
 | This is a documentation subpage for Template:Install user script. It may contain usage information, categories and other content that is not part of the original template page. |
 | 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.
Usage
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}}
- Replace
script_pathwith the full .js page name of the user script to be installed. - The template must be substituted (
subst:), or else it won't work. - Bypass your cache after saving the page.
Example
{{subst:iusc|User:TheDJ/sharebox.js}}
- Produces:
importScript('User:TheDJ/sharebox.js'); // Backlink: [[User:TheDJ/sharebox.js]]
importScript() 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().
See also
- {{Load user script}} ({{Lusc}}) – Version of this script that uses the
mw.loader.load()method.