Getting started with wrld.js

1. Sign up and get an API Key

2. Get wrld.js

Install using a package manager…

  • yarn: yarn add wrld.js

  • NPM: npm install wrld.js

… or reference from a CDN

Add the following lines to the <head> section of your HTML file:

<script src=""></script>
<link href="" rel="stylesheet" />

3. Add the map to your page

The last step is to insert your API key and you’re good to go!

You can do this whenever you create a new map:"map", "your_api_key_here").

Here is a complete live example (drag the map!):

<script src=""></script>
<link href="" rel="stylesheet" />
<div id="map" style="height: 250px"></div>
<script>"map", "your_api_key_here");</script>

Console errors?
Seeing Eegeo:: Bad API Key - Sign up at to get a wrld.js API Key? You probably forgot to insert your API key when creating your map!

4. Add some features

Now that you have your first map, let’s add some features to it!

Take a look at some of our examples to get up and running:


Got a question?

Feel free to email us at or use our Messenger to chat to us directly!

Got a feature request, or found a bug?

Feel free to submit to the wrld.js issue tracker on GitHub.


If you see Cross-Origin Request Blocked (or anything to do with CORS) while doing local development:

  1. Save your page as index.html
  2. Open a command prompt in this directory
  3. Run the command: python -m SimpleHTTPServer 8000
  4. Browse to http://localhost:8000/

For more information, there’s a github issue with more details & solutions.