Upstream version 9.38.198.0
[platform/framework/web/crosswalk.git] / src / chrome / common / extensions / docs / templates / articles / manifest / icons.html
1 <h1 id="icons">Manifest - Icons</h1>
2
3 <p>
4 One or more icons that represent the extension, app, or theme.
5 You should always provide a 128x128 icon;
6 it's used during installation and by the Chrome Web Store.
7 Extensions should also provide a 48x48 icon,
8 which is used in the extensions management page
9 (chrome://extensions).
10 You can also specify a 16x16 icon to be used as the favicon
11 for an extension's pages.
12 The 16x16 icon is also displayed in the experimental extension
13 <a href="http://developer.chrome.com/extensions/infobars">infobar</a>
14 feature.
15 </p>
16
17 <p>
18 Icons should generally be in PNG format,
19 because PNG has the best support for transparency.
20 They can, however, be in any format supported by WebKit,
21 including BMP, GIF, ICO, and JPEG.
22 Here's an example of specifying the icons:
23 </p>
24
25 <pre data-filename="manifest.json">
26 "icons": { "16": "icon16.png",
27            "48": "icon48.png",
28           "128": "icon128.png" },
29 </pre>
30
31 <p class="note">
32 You may provide icons of any other size you wish, and Chrome will attempt to use
33 the best size where appropriate. For example, Windows often requires 32-pixel
34 icons, and if the app includes a 32-pixel icon, Chrome will choose that instead
35 of shrinking a 48-pixel icon down. However, you should ensure that all of your
36 icons are square, or unexpected behavior may result.
37 </p>
38
39 <p>
40 If you upload your extension, app, or theme using the
41 <a href="https://chrome.google.com/webstore/developer/dashboard">Chrome Developer Dashboard</a>,
42 you'll need to upload additional images,
43 including at least one screenshot of your extension.
44 For more information,
45 see the
46 <a href="http://code.google.com/chrome/webstore/">Chrome Web Store
47 developer documentation</a>.
48 </p>