Tutorial: Getting Started (Hello, World!)

Contents

1. Get your browser ready
   1. h3Name
2. Create and load an extension
   1. h3Name
3. Add code to the extension
   1. h3Name
4. Now what?
   1. h3Name
5. API reference
   1. Properties
      1. propertyName
   2. Methods
      1. methodName
   3. Events
      1. eventName
   4. Types
      1. id

This tutorial walks you through creating a simple extension. You'll add an icon to Google Chrome that, when clicked, displays an automatically generated page. The icon and page will look something like this:

Get your browser ready

Extensions are supported on the normal, "stable channel" release of Google Chrome for Windows. To develop extensions on Linux or Mac, you need to get on an early access release channel of Google Chrome.

• Windows: Use any release of Google Chrome
• Linux: Subscribe to the Beta channel
• Mac: Subscribe to the Dev channel

Create and load an extension

In this section, you'll write an extension that adds a browser action to the toolbar of Google Chrome.

1. Create a folder somewhere on your computer to contain your extension's code.
2. Inside your extension's folder, create a text file called manifest.json, and put this in it:

   {
     "name": "My First Extension",
     "version": "1.0",
     "description": "The first extension that I made.",
     "browser_action": {
       "default_icon": "icon.png"
     },
     "permissions": [
       "http://api.flickr.com/"
     ]
   }

3. Copy this icon to the same folder:
   

   Download icon.png

4. Load the extension.
   1. Bring up the extensions management page by clicking the Tools menu and choosing Extensions.
   2. If Developer mode has a + by it, click the + to add developer information to the page. The + changes to a -, and more buttons and information appear.
   3. Click the Load unpacked extension button. A file dialog appears.
   4. In the file dialog, navigate to your extension's folder and click OK.

If your extension is valid, its icon appears next to the address bar, and information about the extension appears in the extensions page, as the following screenshot shows.

Add code to the extension

In this step, you'll make your extension do something besides just look good.

1. Edit manifest.json to add the following line:

     ...
     "browser_action": {
       "default_icon": "icon.png",
       "popup": "popup.html"
     },
     ...
   

   Inside your extension's folder, create a text file called popup.html, and add the following code to it:

   CSS and JavaScript code for hello_world

2. Return to the extensions management page, and click the Reload button to load the new version of the extension.
3. Click the extension's icon. A popup should appear that displays the contents of popup.html.

It should look something like this:

If you don't see the popup, try the instructions again, following them exactly. Don't try loading an HTML file that isn't in the extension's folder — it won't work!

Now what?

Here are some suggestions for what to do next:

• Read the Overview
• Learn how to debug extensions by following the debugging tutorial
• Keep up to date with the latest news: subscribe to chromium-extensions
• Look at some sample extensions
• Watch some videos, such as How to build an extension