The Story Map Basic is a simple map viewer with a minimalist user interface.
Switch branches/tags
Nothing to show
Clone or download
Latest commit 2693827 Sep 20, 2018

Story Map Basic

The Story Map Basic app is a simple map viewer with a minimalist user interface. Apart from the title bar and an optional legend, the map fills the screen. Use this app to let your map speak for itself. Your users can click features on the map to get more information in pop-ups.


View it live | Download

This application is part of the ArcGIS Online and can be accessed from the ArcGIS Online's map viewer Share window. This repository provides the application source code for developers that want to customize the application.

For more information, including a gallery of examples and a step-by-step tutorial, please see the Story Map Basic page on the Esri Story Maps website. This application is based on the Viewer configurable application template.


First create your Story Map Basic in ArcGIS Online using the step-by-step tutorial. Once your story is ready, you have to find its ID in ArcGIS Online. The ID is a 32 character string that you will find in your web browser's address bar when you are viewing the story.

App ID

  1. Download the application
  2. Deploy the application on your webserver. See FAQ for details
  3. Edit config\defaults.js, find the appid property on line 21 and paste in your application ID
  4. Navigate to index.html (e.g.,

Enjoy! You can continue to use the configuration interface in ArcGIS Online to modify your story.

If you are using Portal for ArcGIS, you have to configure config\defaults.js > sharinghost line 63. For example if you Portal is accessible at, the value should be "sharinghost": location.protocol + "//" + "" Optionally you can also configure the application to use the ArcGIS API for JavaScript included on your Portal.

Alternatively, the application can be configured with a webmap id instead of an application id (see config\defaults.js > webmap on line 22. In that scenario, all the configuration has to be done through through config\defaults.js.

Feedback / support

We would love to hear from you!

When you contact us, don't hesitate to include a link to your application to make it easier for us to understand what you are working on.


What are the supported browsers?

The application is supported on Internet Explorer 9 and above, Chrome, Firefox, Safari and the most recent tablet and smartphone devices.

Can the application be used without ArcGIS Online or Portal for ArcGIS?

Yes, by setting app/templatesConfig.js > useLocalWebmap to true, the application will load the local definition of a webmap defined stored in demoMap.js. To modify this file, and add your own layer, see the web map specification or inspect the network request when loading a map.

Can the application be used offline?

Yes, by using Portal for ArcGIS and configuring the application to use the ArcGIS API for Javascript included with the Portal.

Change all references to the ArcGIS API for JavaScript in index.html to refer to your local copy of the API. Search for the references containing // and replace this portion of the reference with the url to your local install. For example: // where gis is the name of your Web Adaptor.

How to deploy the application on a web server?

If you are not familiar with web servers here is three solutions:

  • Use a free hosting service like Surge, View our blog post: Host Your Story Maps for Free with Surge
  • Use the web server that comes with your server Operating System. On Windows this is Internet Information Services (IIS), if you have a C:\inetpub\wwwroot folder on your computer, you should be able to access it's content using http://localhost
  • On Windows or Mac OS, use a simple web server like Mongoose (not recommended for production)

If you are experiencing some rendering issues like improper symbol appearing instead of icons, you will have an extra configuration to perform. Some servers require to configure a new mime type to be able to serve fonts correctly. See the following links for more information:


  • Notepad or HTML editor
  • Some background with HTML/CSS/Javascript
  • Experience with the ArcGIS Javascript API is helpful


Find a bug or want to request a new feature? Please let us know by submitting an issue.


Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.


Copyright 2013 Esri

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

A copy of the license is available in the repository's LICENSE.txt file.