- add sources.
[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.html">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 <b>Important:</b>
33 Use only the documented icon sizes.
34 <br><br>
35 You might notice that Chrome sometimes resizes these icons down to smaller
36 sizes. For example, the install dialog might shrink the 128-pixel
37 icon down to 69 pixels.
38 <br><br>
39 However, the details of
40 Chrome's UI may change between versions, and these changes assume that
41 developers are using the documented sizes. If you use other sizes,
42 your icon may look bad in future versions of the browser.
43 </p>
44
45 <p>
46 If you upload your extension, app, or theme using the
47 <a href="https://chrome.google.com/webstore/developer/dashboard">Chrome Developer Dashboard</a>,
48 you'll need to upload additional images,
49 including at least one screenshot of your extension.
50 For more information,
51 see the
52 <a href="http://code.google.com/chrome/webstore/">Chrome Web Store
53 developer documentation</a>.
54 </p>