3 <title>npm-deprecate</title>
4 <meta http-equiv="content-type" value="text/html;utf-8">
5 <link rel="stylesheet" type="text/css" href="../../static/style.css">
6 <link rel="canonical" href="https://www.npmjs.org/doc/api/npm-deprecate.html">
7 <script async=true src="../../static/toc.js"></script>
12 <h1><a href="../api/npm-deprecate.html">npm-deprecate</a></h1> <p>Deprecate a version of a package</p>
13 <h2 id="synopsis">SYNOPSIS</h2>
14 <pre><code>npm.commands.deprecate(args, callback)
15 </code></pre><h2 id="description">DESCRIPTION</h2>
16 <p>This command will update the npm registry entry for a package, providing
17 a deprecation warning to all who attempt to install it.</p>
18 <p>The 'args' parameter must have exactly two elements:</p>
20 <li><p><code>package[@version]</code></p>
21 <p> The <code>version</code> portion is optional, and may be either a range, or a
22 specific version, or a tag.</p>
24 <li><p><code>message</code></p>
25 <p> The warning message that will be printed whenever a user attempts to
26 install the package.</p>
29 <p>Note that you must be the package owner to deprecate something. See the
30 <code>owner</code> and <code>adduser</code> help topics.</p>
31 <p>To un-deprecate a package, specify an empty string (<code>""</code>) for the <code>message</code> argument.</p>
32 <h2 id="see-also">SEE ALSO</h2>
34 <li><a href="../api/npm-publish.html"><a href="../api/npm-publish.html">npm-publish(3)</a></a></li>
35 <li><a href="../api/npm-unpublish.html"><a href="../api/npm-unpublish.html">npm-unpublish(3)</a></a></li>
36 <li><a href="../misc/npm-registry.html"><a href="../misc/npm-registry.html">npm-registry(7)</a></a></li>
41 <table border=0 cellspacing=0 cellpadding=0 id=npmlogo>
42 <tr><td style="width:180px;height:10px;background:rgb(237,127,127)" colspan=18> </td></tr>
43 <tr><td rowspan=4 style="width:10px;height:10px;background:rgb(237,127,127)"> </td><td style="width:40px;height:10px;background:#fff" colspan=4> </td><td style="width:10px;height:10px;background:rgb(237,127,127)" rowspan=4> </td><td style="width:40px;height:10px;background:#fff" colspan=4> </td><td rowspan=4 style="width:10px;height:10px;background:rgb(237,127,127)"> </td><td colspan=6 style="width:60px;height:10px;background:#fff"> </td><td style="width:10px;height:10px;background:rgb(237,127,127)" rowspan=4> </td></tr>
44 <tr><td colspan=2 style="width:20px;height:30px;background:#fff" rowspan=3> </td><td style="width:10px;height:10px;background:rgb(237,127,127)" rowspan=3> </td><td style="width:10px;height:10px;background:#fff" rowspan=3> </td><td style="width:20px;height:10px;background:#fff" rowspan=4 colspan=2> </td><td style="width:10px;height:20px;background:rgb(237,127,127)" rowspan=2> </td><td style="width:10px;height:10px;background:#fff" rowspan=3> </td><td style="width:20px;height:10px;background:#fff" rowspan=3 colspan=2> </td><td style="width:10px;height:10px;background:rgb(237,127,127)" rowspan=3> </td><td style="width:10px;height:10px;background:#fff" rowspan=3> </td><td style="width:10px;height:10px;background:rgb(237,127,127)" rowspan=3> </td></tr>
45 <tr><td style="width:10px;height:10px;background:#fff" rowspan=2> </td></tr>
46 <tr><td style="width:10px;height:10px;background:#fff"> </td></tr>
47 <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr>
48 <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr>
50 <p id="footer">npm-deprecate — npm@2.11.3</p>