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.
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.
- Download the application
- Deploy the application on your webserver. See FAQ for details
config\defaults.js, find the
appidproperty on line 21 and paste in your application ID
- 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
sharinghost line 63. For example if you Portal is accessible at
acme.com/gis/, the value should be
"sharinghost": location.protocol + "//" + "acme.com/gis/"
Alternatively, the application can be configured with a webmap id instead of an application id (see
webmap on line 22.
In that scenario, all the configuration has to be done through through
Feedback / support
We would love to hear from you!
- StoryMaps Website
- Let us know about your application
- Story Maps forum on GeoNet
- ArcGIS Blog
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
true, the application will load the local definition of a webmap defined stored in
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?
Search for the references containing
//js.arcgis.com/3.15 and replace this portion of the reference with the url to your local install.
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\wwwrootfolder on your computer, you should be able to access it's content using
- 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
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.