Esri Story Maps are a simple yet powerful way to inform, engage, and inspire people with any story you want to tell that involves maps, places, locations, or geography. They make it easy for you to harness the power of maps to tell your story.
Esri Story Maps are web applications that let authors combine beautiful maps with narrative text, striking images, and multimedia, including video. The applications are designed to be attractive and usable by anyone, which makes them great for education and outreach, either to the general public or to a specific audience.
Story maps can be made for a wide variety of subjects. Anything that you can show on a map can be the subject of a story map!
You may want to tell a personal story about a trip or a place you love. Or you may want to tell a story for the agency or organization you work for to showcase plans and projects, to engage supporters and stakeholders, to promote a city or region, and so forth. It's all about getting your message across in a compelling way.
Want to get some ideas and get inspired? Check out the story map examples featured on the Story Maps home page. Then, to see more, go to the Story Maps Gallery. You can filter and search the gallery to find story maps about subjects similar to what you may have in mind.
Esri Story Maps are built into ArcGIS, the world's leading mapping and GIS platform. Anyone with any type of ArcGIS account can create story maps at no extra cost. You can sign up for a free non-commercial ArcGIS public account or sign in with your Facebook or Google credentials. You can also purchase an ArcGIS subscription to access premium datasets, publish your own datasets, perform geo-analysis, set up enterprise-wide use, and more.
First think about your subject, your intended audience, and how you want to tell your story to them. We recommend visiting the Story Maps Gallery for ideas and inspiration to see how other authors have handled similar topics to yours.
Next go to the Story Maps Apps list to browse the application templates that we provide and choose the best one for your story map project. Each app lets you deliver a specific user experience to your audience. There are apps for map-based tours, collections of points of interest, in-depth narratives, presenting multiple maps, and so on. Spend some time comparing the apps to see the different components they let you incorporate in your story. We encourage you to check out which app best suits your project and determine its requirements before getting started.
Each application template has a tutorial page that guides you through the authoring process. The apps have interactive builders that make it easy to assemble your story. You'll be prompted to sign in with your ArcGIS account (if you are not already logged in). You can create your web maps in ArcGIS first and then reference them when you build your story, but some of the apps also let you create and edit your maps from within their interactive builders, so you can do your mapping as part of building your story. You can think of Esri Story Maps as one of several ways to publish your ArcGIS web maps and put them to work.
See also How to Make a Story Map.
As part of ArcGIS Online, the web maps used in Esri Story Maps and the data they present are hosted in the ArcGIS Online cloud. Story Maps let you use the full power of the world's leading mapping platform to create maps for your stories. In ArcGIS Online, you can combine your data with the wide range of authoritative, trusted spatial data published by Esri and many leading agencies, and choose from the range of cartographically rich basemaps that are also built into the system. Your maps can also include data being served with Esri's ArcGIS Enterprise. If you are using ArcGIS Enterprise to create story maps, your maps will be stored in your enterprise's own on-premises cloud infrastructure.
No. The Story Map application templates are hosted in ArcGIS, so there's nothing to download or install when you create a story map. You simply launch the interactive builder for the app you want to use to author and publish your story.
You also have the option to download the source code for any of the Story Map application templates and install it on your own website or web server instead. This enables your story's URL to reflect your own web domain, and also allows you to tweak or customize the source code to further tailor the application beyond the options available in the app's builder. To get started with hosting a Story Map app's source code, please see this blog post. To see some great examples of customizations that people have made to the Story Map apps, click this link to open the Story Maps Gallery with the 'Customized' option in the gallery's 'Format' menu already selected. Note that if you choose to download and self-host an app, its source code will therefore not automatically reflect updates that we make to the version that is hosted in ArcGIS, as we fix issues and make enhancements.
Yes. Although the example story maps you see on this website and in the gallery are all shared publicly so you can access them, not all story maps have to be shared that way. You can also create story maps containing proprietary business or enterprise information that is not intended for public use and restrict access to them. In this way, you can use the benefits of story maps within your enterprise to present information.
As part of ArcGIS Online, Story Maps use the standard ArcGIS Online security and sharing model. When you author a story map, you decide when you are ready to share it so that other people can start viewing it, and you can choose how you want it be shared. When you share a story map publicly, anyone in the world with a web browser can access it. Your audience is unlimited. This level of sharing ensures the maximum exposure for your story map. It's great for outreach, advocacy, and getting your message out there.
When you share a story map just to your organization, only people who have accounts in your organization's ArcGIS subscription will be able to sign in and see your story. This level of sharing is a feature of having an ArcGIS subscription and is not available to users of the free, noncommercial ArcGIS public account. It is also possible to configure ArcGIS Online in your enterprise so that users can use their standard enterprise logins to gain access. See the answer to the next question, too.
Yes. See this blog post.
Yes. ArcGIS Enterprise enables an enterprise to set up its own cloud-based mapping infrastructure, providing the same capabilities as ArcGIS Online to its staff. With ArcGIS Enterprise, maps, apps, and data are hosted on the enterprise's own servers rather than in Esri's cloud. Story maps authored with ArcGIS Enterprise are normally shared just within the enterprise. The Story Map applications that are available in your ArcGIS Enterprise deployment depend on which version of ArcGIS Enterprise you are using. Our app updates are released first in ArcGIS Online and then included in the next ArcGIS Enterprise release. This means that the version of our apps that you see in ArcGIS Online may be different from the version in your deployment of ArcGIS Enterprise, depending on the ArcGIS Enterprise version you are using. Note it is currently not planned to make Story Map Shortlist available in ArcGIS Enterprise.
Developers using ArcGIS Enterprise can also download and self-host the source code for any of the Story Map apps in order to customize their look and feel. To configure a self-hosted app to point at your ArcGIS Enterprise Portal, you would change the DEFAULT_SHARING_URL setting in the app's config.js file.
Once you've created and shared a story map, you will want to make sure your intended audience sees it. You'll also want to get the word out and promote it, just like any other web-based resource that you want people to use.
You can add a link to your story map to a web page that your audience will be visiting. For example, if your story map is about a project your organization is planning, you could add a link to the web page for that project, so that people can launch your story map when they read about the project. It's good to include a small screen capture of your story map with that link on that page to attract people. Alternatively, you can embed your story map directly in the page, so people landing on the page can immediately start using it. See this blog post for tips about embedding story maps in web pages. You can find some good examples of both of these approaches in the Story Maps Gallery: click these links to see linked or embedded examples.
Story maps are also good to show at presentations, classes, and workshops to engage people and influence decision makers and stakeholders.
If your story map is intended for the general public, you can promote it via blog posts, email blasts, and social media.
One way to maximize the reach of your story map is to issue a press release to try to get a media outlet to write about the subject covered in your story map or use it to illustrate a story they are already working on. Good maps are compelling, and journalists are happy to include them in their articles to help engage their readership.
For general tips about things to check before you go public with a high profile story map, see this blog post.
You can discover tips, best practices and info about new features in the Story Maps blog.
If you are a developer looking to enhance and customize the Story Map apps, see the Story Maps Developers' Corner.
To browse or search all Esri blog posts about story maps, including posts from both of the sources mentioned above, click this link to get a listing of every post. We maintain this listing in Geonet, the Esri Community. You can filter the listing by typing in a search term.
You can ask questions in the Story Maps Forum on GeoNet, the Esri Community. You can browse questions and answers other authors have posted. Esri Story Maps team members also monitor the forum and frequently respond to questions. We also add posts into Geonet letting you know about new software releases, new blog articles, and upcoming events like workshops.
The Story Maps Gallery is a showcase of just some of the great story maps that have been created by the storytelling community. It is intended to show the world some of the ways in which people are putting storytelling with maps to use, and to help authors find ideas and inspiration for their own stories and projects. The Gallery is curated by the Esri Story Maps team. The Gallery doesn't contain all the story maps that have been created, or even all the good ones. It is just a selection of stories we've hand-picked to highlight particular subjects, best practices and approaches, especially if they could help spark the creative juices for new story map authors. Bear in mind that having a story map in the Gallery doesn't promote that story to the audience it was created for: it is still up to you, the author, to get your story in front of your intended audience.
Originally, we provided the ability for authors to submit their story maps for consideration to be added into the Gallery. However due to the increasing volume of story maps that are being created, and the number of submissions we have been receiving, we have discontinued accepting submissions. It's not that we don't want to see your work. It's just that it was getting hard to keep up with the number of worthy stories being produced, and we didn't like to have to turn down submissions. Instead, we now curate the Gallery by keeping an eye out on new story maps that are being created, for example, by monitoring story maps that authors and organizations are sharing and promoting on Twitter.
To get recognition for your storytelling work, look out for the Esri Storytelling With Maps Contest that is held annually. You can find links to the winners of the annual contest on the Story Maps Resources page. Be sure to sign up for the Planet Story Maps e-mail newsletter to find out about upcoming contests. The Esri International User Conference, and other regional and local user conferences, also include opportunities for sharing your work with the user community.
Go to the My Stories section of the Story Maps website. My Stories lets you administer and manage the story maps you create. If you are not already signed in with your ArcGIS Online account, you'll be prompted to sign in when you go to My Stories.
My Stories automatically checks your story maps for issues that would prevent them from working correctly for your audience, and tells you how to fix any issues it finds. For example, if your story map is intended for the general public but one of the web maps it contains is not currently shared publicly, My Stories will alert you and enable you to correct the issue.
As Story Maps are part of ArcGIS Online, you can also access your story maps—along with all your other ArcGIS Online-based web apps, web maps, and data—in the Content > My Content section of ArcGIS Online or My Content in your ArcGIS Enterprise Portal. The difference is that My Content lists everything you own, whereas My Stories filters the listing to show only your hosted story map applications. Think of it as a story map-centric view of your ArcGIS Online content. So if you are working on story maps, My Stories makes it easy to manage your work.
Tip: If you are unable to sign in to My Stories, or checking a particular story causes a problem where you are signed out of My Stories, you can reload the Story Maps website to continue working. You can also open your story maps from My Content in ArcGIS instead.
You probably have web maps or layers in your story map that are not shared publicly. All the content in your story map needs to be shared publicly in order for the public to use it. Go to My Stories, sign in with your account, and expand that story map's entry in the listing, and My Stories will notify you if any of your story map's content has issues that will cause your readers to be prompted to sign in. Alternatively if you are using Story Map Journal or Story Map Series, you can open your story and the builders for those apps will automatically check your story content and warn you of any issues.
Note that My Stories does not check the status of Story Map apps that you have embedded into a story map. For example if you have embedded, say, a Story Map Swipe and Spyglass app into a public Story Map Series, and that Swipe and Spyglass app is not shared publicly, people who read your Map Series app will be prompted to sign-in. My Stories does not alert you about the status of apps you embed so take care to ensure they are shared correctly.
The My Stories section of this website lists the story maps you have created in ArcGIS Online using any of the Story Map applications, with the exception of Story Map Basic. Story Map Basic will be supported in a future release.
If your story map is not appearing in My Stories, it may be using an earlier version of that application. Story Maps using early versions of our hosted applications are not listed in My Stories until they are updated. The "Not Seeing Your Story" button in My Stories lets you find and automatically update these stories.
If you deployed your story by downloading and self-hosting one of the apps, it will only be listed in My Stories if your story is configured via an application ID. If it is configured via a web map, it will not be listed.
There are some issues currently that can cause My Stories to appear to throw you out and give you a Page Not Found error. We are looking into these issues when we find them and are addressing them with each new update we make to the software. We're sorry if this happens to you and understand that it is unexpected. The good news is that if this happens, you have not lost any work and your Story Maps are safe. The Page Not Found error is a cosmetic issue and not an issue with your Story Maps or other data. To find your Story Maps and continue working with them, you can go to the Content > My Content section of ArcGIS Online or My Content in your ArcGIS Enterprise Portal. My Content gives you access to all the apps (including Story Maps), web maps, and other resources you have created with ArcGIS, such as data layers. My Stories is simply a utility that we provide to give you a Story Maps-focussed view of your ArcGIS content, so it hides ArcGIS web mapping apps that aren't Story Maps and provides some additional tools, like content checking for Story Maps. You can still launch, create and edit Story Maps directly from My Content in ArcGIS: you don't have to use My Stories. You should be able to return to My Stories to use it after you get a Page Not Found error, but it is also possible that the problem will persist or reoccur, in which case it is best to use My Content in ArcGIS to access and manage your Story Maps.
Yes. My Stories lets you work directly with the items you own in ArcGIS Online representing hosted story map applications. So if you add a thumbnail or tags to an item, edit its title or summary, and so on, that change is reflected in ArcGIS Online. So, for example, the more relevant tags you add to your story map in My Stories, the easier it will be to find when people search ArcGIS Online or any searchable gallery based on ArcGIS Online content. Similarly, if you delete a story map in My Stories, you are deleting that story from ArcGIS Online.
If you have deployed a story map by downloading and self-hosting the code for the app (for example because you wanted to customize the code), and you configured your self-hosted story map by referencing the AppID of an underlying application you created with the template's interactive builder, you will see that application listed in My Stories. This enables you to check and monitor the status of the underlying application that is used in your self-hosted story map.
If you configured your self-hosted story map by referencing a web map, your story map will not be listed in My Stories.
You can manually add a web mapping application item entry into ArcGIS Online to represent your self-hosted story map (by using the Add Item > An Application button in Content > My Content in ArcGIS Online) so that people who search ArcGIS Online can find your self-hosted story map, and so that it can be added into ArcGIS Online-based galleries, such as the Story Maps Gallery. However, story maps represented by these manually added item entries are not displayed in My Stories.
Yes. If your enterprise is using Esri's ArcGIS Enterprise, you can create story maps using the hosted story map application templates built into that product, and My Stories can be used to manage those stories. My Stories is available in ArcGIS Enterprise starting at version 10.4. My Stories can be accessed in your ArcGIS Enterprise Portal at https://[myportal.com]/[arcgis]/apps/MyStories. Story maps can also be managed in your ArcGIS Enterprise Portal using My Content.
As part of ArcGIS Online, story maps use ArcGIS Online's security model. As an ArcGIS Online app, a story map can normally only be edited by its owner. However if you are using an ArcGIS subscription (and are therefore the member of an ArcGIS organization) there are three ways in which you can collaborate with colleagues on editing web maps and apps, including story maps. Firstly, the Administrator of your organization can edit any item in that organization. For example, if a grammatical error or typo was found in a story map that has been released to the public an administrator can correct the change immediately. Secondly, certain members of the organization who are not administrators can be given a 'custom role' that enables them to edit any item in that organization. Thirdly, ArcGIS groups called 'collaboration groups' can be set up inside an organization to support project-based or team-based activities. All the members of a collaboration group can edit any items that have been shared into the group. With all these workflows, you have to take care not to have multiple people trying to edit the same items at the same time, because this will result in changes being overwritten. Note that in order to edit Story Map Tour or Story Map Shortlist stories in a collaboration group, both the app and the web map in which the app stores its places, have to be shared into the group.
See this blog post for more information.
Duplicating your story map can be useful for a variety of reasons, such as making a backup copy or reusing the same look and feel for another story. This is not currently supported in the Story Map app builders or directly in ArcGIS Online. You can use the unsupported ArcGIS Online Assistant tool to help duplicate your application. You can make a backup copy of any web map by opening it in ArcGIS Online and then choosing Save As.
Note that if you copy a story map using ArcGIS Online Assistant, images that are uploaded into your story are not also copied. The images referenced in the copied story map still point at the original story map, so you would have to upload the images again to make your copied story self-contained. Also we do not recommend copying a story that uses the Story Map Shortlist or Story Map Tour app templates. Those apps store the places they contain in an associated web map which is not copied if you copy the story map, and there's no way to point the copied story map at a different web map. For example if you copy a Shortlist, both the copy and the original Shortlist will point at the same web map, so you can lose data if you continue to make edits to both Shortlists.
To copy a story map between two different ArcGIS Organizations or portals, see this blog post.
When your story map is posted on social media like Facebook and Twitter, the post will use the thumbnail, title, and summary of your story, as defined in the web mapping application item details page in ArcGIS representing your story map app. So make sure that entry in ArcGIS has a good looking thumbnail, a title that matches the actual title of your story map, and a useful summary. Remember that the summary in the item details page isn't automatically the same as the subtitle (if any) your story map have. Be sure to update the summary in the item details to make it useful: don't just repeat the title of your story map in the summary. People will see both the title and the summary from the item details page in tweets, Facebook posts and search results. For example if your story has a subtitle you can copy and paste it into the summary. You can edit the name, thumbnail and summary of your stories either in My Stories or in Content > My Content in ArcGIS.
If have downloaded the source code for a Story Map app and are self-hosting the code, see this blog post for info about how to improve the appearance of your story on social media.
Delete protection is a setting you can enable for any item in ArcGIS, such as your story map and any web maps that you authored for it. To delete protect any item in ArcGIS, go to Content > My Content and open its item details. Note that some web maps created automatically by Story Map apps, such as the web map that gets created if you import point data into Story Map Shortlist as places, are delete protected for you by default. We also recommend using folders in ArcGIS My Content to organize your work. For example, you could make a folder for each of your story maps and put any web maps created for that story into that folder. See this blog post for more info.
Yes. We provide the source code for each of the Esri Story Map applications licensed under the Apache 2.0 license and distributed on GitHub. The source code can be freely downloaded and modified by developers, and the modified application can be deployed on a web server. Esri also welcomes your contributions to the code. You can find the link to each GitHub repository on each application's overview page on the Story Maps website. You can also access all the GitHub repos here.
To get started with hosting a Story Map app's source code, please see this blog post.
You can find more info and tips for developers in the Story Maps Developers' Corner.
While most story maps are created using one of the Story Map app templates we provide, story maps can also be created from scratch by developers using the developer APIs and tools in ArcGIS for Developers. We call these custom story maps or custom designs. You can find examples of custom designs in the Story Maps Gallery here. The Esri Story Maps team regularly creates custom designs to provide storytelling user experiences that aren't available in the standard Story Map apps to help prototype new user experiences and patterns. Our most popular custom creations often go on to be turned into Story Map application templates that anyone can use. So if you see a custom story map you like, stay tuned, because we may be working on making it a template!
You can also customize the Story Map app templates that we provide. You can download the source code, make changes, and then host the code on your own website or web server. You only need to host the code yourself. Your maps and data remain hosted in ArcGIS. When the Story Map app templates are customized, these aren't called custom designs, they are simply customizations. To get started with hosting a Story Map app's source code, please see this blog post. To see some great examples of customizations that developers have made to the Story Map app templates, click this link to open the Story Maps Gallery with the 'Customized' option in the gallery's 'Format' menu already selected. Note that if you choose to download and self-host the source code for an app, your source code will therefore not automatically reflect updates that we make to the version that is hosted in ArcGIS as we fix issues and make enhancements.
Yes, story maps can be viewed on all commonly used web browsers on computers, tablets and phones. Apart from Story Map Basic, the apps have responsive layouts that adjust automatically when displayed on smaller screens, such as on mobile devices, or if they are embedded inside smaller frames on web pages.
Story maps can be authored on all commonly used web browsers with the following exceptions:
For best performance and experience, use the latest web browser version. Internet Explorer users should use version 11. We don't support earlier versions of Internet Explorer, and you may see features that don't work or unexpected issues if you use them to view or author a story.
For viewing or authoring Story Map Shortlists on Windows 10 we don't recommend Internet Explorer: there's currently a technical issue that sometimes causes an incorrect screen refresh. This is not an issue with Internet Explorer on Windows 7.
For authoring Story Map Tours we don't recommend Internet Explorer or Edge: there's currently a technical issue that prevents dragging over text to select it for editing when authoring tours using the Three Panel or Integrated layouts.
Yes. Story maps are part of the ArcGIS platform, so Esri technical support is available.
Currently story maps do not support offline usage. To use your story map, your readers need to be connected to the Internet, or to your enterprise network in the case of ArcGIS Enterprise. The Story Map Journal and Story Map Cascade apps have a print option (accessed via the Link button in their header) that can be used to create a PDF file.
Yes.
In the Story Map Cascade app you can include an ArcGIS 3D web scene in a section. You can choose a scene via the Media Picker dialog in that app's builder.
In the Story Map Journal and Story Map Series apps, you can use an ArcGIS 3D web scene instead of a web map for a journal section or series entry. Once you've created your web scene, or found an existing one you want to use, open it in ArcGIS Online and copy the URL of the web scene viewer. In the Story Map Journal or Story Map Series Builder, choose the option to embed a web page. Paste your URL into the dialog box. For the best results, append &ui=min to the end of your URL to hide the viewer's header and scene creation tools that won't be needed in your embedded scene. See the following example:
http://story.maps.arcgis.com/home/webscene/viewer.html?webscene=91b46c2b162c48dba264b2190e1dbcff&ui=min
See this blog post for more details.
It is possible to do this in Story Map Journal, Story Map Series and Story Map Cascade using the option to embed a web page. Note that this may cause your story map to load more slowly depending on what you are embedding. Always use the Fill option in Story Map Series and Story Map Journal when you embed web content into them so that the embedded content expands to fill the available display. Story Map apps can be embedded into the three apps mentioned above. For example you can embed a Story Map Journal into a Story Map Series tab. Another common pattern is to embed a Story Map Swipe and Spyglass into a Story Map Journal section. When you embed the Story Map Tour or Story Map Swipe and Spyglass apps, you can append the &embed parameter to the app's URL to remove the app's header.
See this blog post and this blog post for more info and tips about embedding web content into your story map.
To troubleshoot embedded content in story maps, including info about using mixed HTTP/HTTPS content, please see this blog post.
See the next question below for important information about using mixed HTTP/HTTPS content.
Esri is enhancing the security of Story Maps
Your Story Maps live on the web, and the web community is always working to establish and implement better security. HTTPS, which provides a secure connection for content transmitted over the internet, is emerging as the expected way to access web content. Most modern browsers now show warning messages when HTTP instead of HTTPS is used. Because of this emerging standard, we strongly recommend you use HTTPS links for authoring and sharing Story Maps, and only use HTTPS URLs when embedding web content or linking to images within a Story Map.
Practically speaking, this means a story map and all its content (including images, layers, embedded apps and websites) must be accessed using links that start with HTTPS rather than HTTP. This ensures the best experience for your readers because most web browsers will indicate that your stories are secure.
What do I need to do?
Esri is working to make this an easy transition for Story Map authors and readers. Tools are available now in Story Map builders and My Stories that help you find insecure content (HTTP) in your stories and provide recommendations for how to address it. Please check your stories for insecure content and update to HTTPS as soon as possible.
What are HTTP and HTTPS anyway?
HTTP and HTTPS are protocols that define how information is sent between your computer and other computers on the web. HTTPS is a secure communications protocol, which means it’s encrypted and protects the information you are sending and receiving so that only the intended recipient can read it.
What can I do if some content doesn't support HTTPS?
The tools provided will check whether your story content supports HTTPS and let you fix your links when possible. If any content currently referenced via HTTP does not support HTTPS you have the following options:
Following these steps will ensure your stories will continue to work well for your readers. If you need help understanding why a server doesn’t seem to support HTTPS or how you can host content on a secure server, check with your IT department.
Some more details about this situation:
What about stories I've already published?
You'll want to use the new tools added to My Stories to check any story maps you have shared, especially those shared with the public. look for any HTTP URLs pointing to images, videos, map layers, web apps, or web pages. You can safely ignore HTTP links for content hosted on arcgis.com. You can also ignore content that you have hyperlinked to; for example, if you created a text hyperlink to a PDF report that opens in a new browser tab that link can be HTTP or HTTPS. You only need to be concerned with content that is loaded inside your story map that is hosted outside the arcgis.com domain.
If you find content referenced with an HTTP link you’ll need to either update the server with a valid certificate so that it will support HTTPS, find an alternate way to host the content securely, or remove the content from your story. If you do need to remove content from a story, you can always add a hyperlink in the story text that will open the content in a new browser tab.
If the content is an image you can upload it in the story map builder or host it on a different web server that does support HTTPS. If the content is a GIS service the recommended path is to update the server to support HTTPS. If that is not feasible you can publish the data to ArcGIS Online or to a server that does support HTTPS. If you do republish the data somewhere else you’ll need to update the URLs in all web maps that use that layer. When updating an existing server to support HTTPS the URL to your content may change (for example, if the port number was included in the URL). In these cases you’ll need to update the URLs in your story.
How can a browser’s web security features affect a story map?
In some cases the problem is obvious, such as when the content embedded in your story map is blocked and doesn't load. In other cases, however, the affects are more subtle. For example, Safari now blocks the use of its geolocation feature if any content — even a single image — is loaded over a non-secure (HTTP) connection. Let’s say you created a Story Map Tour, and when you added your organization’s logo to the header you pasted in an HTTP link to the logo image. This means that anyone trying to use to your story over HTTPS using an iPhone or iPad won’t be able to tap the “locate me” button to locate themselves on the map. While your story will still load and otherwise be usable in this case, it’s not providing the intended experience for your readers. Web browsers are always implementing new security features like this to keep users safe. The issue mentioned in this example may only affect Safari users today, but soon other browsers are likely to implement this safety measure as well.
Need more info about web security and HTTPS/HTTP?
In order to use premium services in a story map, you need to authenticate the service. This may consume credits from your organization when others access your story. See this blog post for more details.
For technical reasons it is no longer possible to use Facebook photos in a story map. Support for Facebook has been removed from all Story Map apps as of September 2016. Please be aware that Facebook photos added before this date may no longer appear correctly. If you have used Facebook photos, we recommend that you check your stories in the My Stories section of this website. My Stories will alert you if any of your story content is broken, including Facebook photos.
Yes. Autoplay mode is useful if you want to show a story map on a public display monitor such as a kiosk in a visitor center or an exhibit and have the story automatically advance. In this mode, a control appears that enables autoplay to be paused and the speed adjusted. During autoplay pause, people can interact with the story map normally and then autoplay resumed. Autoplay is supported in all the Story Map app templates except for Story Map Basic. In Story Map Swipe and Spyglass, autoplay is supported when a swipe series has been defined.
To enable autoplay for a story map, click the Link button in the header and in the dialog that appears, which gives a short URL to the story map, click the Autoplay mode check box. This will add the autoplay parameter into the short URL that is generated. Note that autoplay mode is not supported on small displays like phones or in small embed frames. See this blog post.
The Story Map Crowdsource app template was originally released in beta in June 2016. Going forward the Esri Story Maps team has decided to focus on narrative and place-based stories where the content is assembled by you, the story author, rather than crowdsourced by your readers. We don't plan to continue to provide a stand-alone crowdsourcing app. Esri offers several other crowdsourcing and data collection apps (see this page to find out more about them). For this reason, in the June 2018 update to ArcGIS Online, Story Map Crowdsource was moved into the Mature Support phase of the Esri Product Lifecycle. This change in status means Story Map Crowdsource will be removed from the ArcGIS Online Configurable Apps Gallery and will no longer be listed on the Story Maps website.
If you have created a story map using Story Map Crowdsource, the story will continue to work and be accessible to your readers. Your readers will continue to be able to contribute to your story, and you'll be able to edit and curate your story. Your Story Map Crowdsource stories will still be listed in My Stories on this website and in My Content on ArcGIS Online. However, as an app in mature support, no new features will be added to Story Map Crowdsource in future releases, and no reported issues or bugs will be fixed.
You can still create a new story using Story Map Crowdsource after it has been moved to mature support, but this is not recommended. While Story Map Crowdsource is still available in its mature phase, changes in ArcGIS or specific web browsers that affect its functionality may break stories created with it at any time. If you accept this risk, you can create a new Crowdsource story from the Story Map Crowdsource item page. In general, Esri recommends that customers using products in mature support don't create new applications using them.
See this blog post for more information.
Section 508 of the Rehabilitation Act of 1973 is a United States Government law that requires federal agencies to make their web content accessible to people with disabilities. Many other countries have similar laws and regulations concerning accessibility. Accessibility is a key goal at Esri to ensure that maps, apps, and data can be accessed by all users.
The Esri Story Maps team started working on Section 508 compliance for Story Maps apps in 2015 and has focused on keyboard navigation, screen reader support, and color contrast as outlined in the World Wide Web Consortium's Web Content Accessibility Guidelines (WCAG). Specifically the Story Map Tour, Story Map Journal, Story Map Series, and Story Map Cascade apps have received accessibility enhancements including optimizations for screen readers and keyboard navigation. More enhancements are planned in this area.
Story Map applications have two components: 1) a Builder that lets an author create a story, and 2) a Viewer that presents the story to the audience. Our approach to accessibility for Story Maps is to focus on accessibility of the Viewer since this is the part of the application that is made available on internal or public websites with which audiences of federal employees and/or citizens interact.
The Story Map Journal app template has in particular been enhanced recently to improve accessibility. See this question in the Story Map Journal section of this FAQ page for details.
For the latest information about accessibility enhancements in Story Maps, see these blog posts.
Story Maps are integrated into Esri technologies that provide geographic content, and both ArcGIS Online (VPAT) and ArcGIS Enterprise (VPAT) are compliant with Section 508. For more information about the Section 508 compliance of Esri's technology see Section 508 and Esri's Commitment to Accessibility or send specific questions regarding Esri's compliance with US, EU, and other similar regulations to Section508@esri.com.
Get full details about what's new with the Story Map apps in our latest What's New blog posts.
Your images can be stored in a variety of places as long as they are accessible on the web. We provide easy access to images in Flickr and Google+/Picasa (note that existing photos in Picasa can be used but Picasa is no longer accepting new uploads). If you are using an ArcGIS subscription account with publisher privileges, you can upload images from your computer directly into the Map Tour Builder so they are hosted in Esri's cloud. This is a convenient option if your images aren't already online, or if you are creating a Map Tour that will be shared only inside your organization using images that you don't want to be accessible publicly. Images have to be in JPG format in order for you to upload them into the Map Tour Builder.
You can also reference images directly by specifying their URL if they are hosted on your own web server or somewhere else on the web. Note that if you reference your images using URLs, those images aren't optimized for the Map Tour, so be aware of the recommended image sizes. See the question below on that subject. If you are not able to resize your images for best performance, we don't recommend referencing them via URLs, and you should host them in Flickr or upload them into your Map Tour instead. Avoid referencing images on the web that you don't have control over: it is a common issue in Map Tours that point at images on the web that those images are no longer accessible because they have been deleted, moved or renamed. Images referenced directly via URLs should use HTTPS. Avoid adding images (or any other content) that can't be referenced via HTTPS. This will give your readers the best experience when they view your story map because it will help ensure that your story is fully compliant with HTTPS, and therefore prevent web browsers warning your readers that your story is potentially insecure. See this FAQ question above for more info on web security and Story Map content.
No. When you launch the Story Map Tour Builder from the Story Maps website, a web map will be created for your tour automatically.
Yes. You can edit the web map used in your tour to add supporting layers such as study area boundaries or a line showing the route between your tour points. To edit the web map, go to My Stories, locate your tour and click Edit Map next to the web map that is listed for it, or go to Content > My Content in ArcGIS and open the web map.
You can use images of any size and shape in a Story Map Tour, but we recommend landscape orientation (i.e. images that are wider than they are tall) instead of portrait orientation. The recommended image aspect ratio is 4:3.
In the Three Panel and Integrated layout options, 4:3 images fill the available area well and maximize the space for your captions without covering up too much of the image. Map Tours created with those two layouts generally look best if all the images have the same size and aspect ratio, so your readers don't get distracted by differently shaped images as they go through your tour.
In the Side Panel layout, we recommend 4:3 images too but bear in mind that images are displayed cropped in that layout based on the shape of the web browser window (except when displayed on phones). If you don't want your images to be displayed cropped, perhaps because they are infographics or diagrams, use the Three Panel or Integrated layout instead.
If you use the option to import images stored in Flickr or Google+/Picasa, Map Tour takes advantage of optimizations in how these services store your photos. Images of any size stored in Flickr or Google+ will load quickly in your story because the Map Tour automatically requests the appropriate size from those systems when it draws the images. It also requests thumbnail size images for the thumbnail carousel displayed by the Three Panel and Integrated layout options.
If you use the option to upload images directly into the Story Map Tour Builder, the builder defaults to automatically resizing images that are wider than approximately 1000 pixels to optmize them for use in the Map Tour. We recommend that you always accept this resizing when you upload an image to add a new place into a tour. The builder does give you the option to not resize images you upload, but if you use this option your image will not be optimized for display, and will result in poor performance if you upload a very large image. If you don't choose the default resizing option, avoid uploading an image that is much more than 400 KB file size. For the image that you use for the optional cover page in the new Side Panel layout, which fills the whole screen, you can get the crispest looking results by uploading an image that is 2000 pixels wide by 1500 pixels tall, and choosing the option to not automatically resize that image, but try to use an image that is less than 400 KB. Note that if you edit the image used for an existing place and upload a different image, that new image is not automatically resized: it is used as-is, so be careful not to use images that are very large when you replace uploaded images. In addition to optimizing the drawing speed of your tour, another reason to avoid uploading very large images is that storing them could use up more ArcGIS Online credits. When you upload images, the builder automatically generates the thumbnail images for the thumbnail carousel.
You can also build Map Tours by referencing images directly on the web via URLs. Bear in mind that if you reference images via URLs the Map Tour Builder doesn't optimize these images for fast display: they are displayed as-is. If you reference images on the web directly via URLs, the file size of each image should ideally be less than 400 KB. Images that are larger than that can slow down performance. It is a common issue in Map Tours that reference images on the web that they are very slow to load because the images have a very large file size. We strongly recommend using JPG format images and saving them at 80% image quality to reduce file size. This doesn't have a noticeable effect on the visual appearance of the image. The file size in KB is more important than the width of the image in pixels in determining speed, but you can of course resize large images to reduce their file size. Images referenced by URLs in Map Tours don't really need to be larger than 1000 pixels wide by 750 pixels tall, so resizing larger images to those dimensions is a good way reduce their file size, but you don't generally don't need to resize your images if they are already 400 KB or less. For the new Side Panel layout, images that are 1000 by 750 pixels look fine, but if you want your Side Panel images to look very crisp on the largest displays, especially the image you use for the optional cover page, which fills the entire display, you could use images that are up to 2000 pixels wide by 1500 pixels tall. If you do use images referenced via URLs that are as large as 2000 x 1500, make sure they don't exceed 400 KB. If you are going to switch an existing Map Tour that uses the Three Panel or Integrated layout to use the Side Panel layout instead, and you will be using the cover page option, you may want to provide a higher resolution image for the first point in your Tour (which is used to define the content for the cover page).
If you author a tour by referencing images on the web via URLs, you need to provide a separate thumbnail image for each place. (If you try and use the same image for a place's main image and its thumbnail, this will slow down performance as the thumbnails draw). For thumbnail images referenced by URLs we recommend a size of 250 pixels wide by 166 pixels tall. The new Side Panel layout doesn't display thumbnails, but thumbnails still have to be specified when you build a Side Panel tour to maintain compatibility with the other layouts.
Remember that images uploaded into Map Tours or referenced via URLs that slow down performance because they are too large may seem to load quickly to you. This is because after you've displayed them once during the authoring process, they are cached in your web browser. However they'll seem slow to people viewing your Map Tour.
If you reference images on the web directly via URLs, make sure these URLs start with HTTPS not HTTP. Avoid adding images (or any other content) that can't be referenced via HTTPS. This will give your readers the best experience when they view your story map because it will help ensure that your story is fully compliant with HTTPS, and therefore prevent web browsers warning your readers that your story is potentially insecure. See this FAQ question above for more info on web security and Story Map content.
Yes. You can load multiple videos from YouTube automatically. You can also reference individual videos in YouTube, Vimeo, and other systems by specifying their URLs. See this blog post for more details. If you are using videos in a Map Tour using the new Side Panel layout, note that you currently can't play the videos within the builder. However the videos can be played when you preview or open your tour. Videos can't be used as the media for the cover page in the Side Panel layout. The Map Tour Builder will let you save a Side Panel Map Tour with a video as the cover media, but that video won't appear in the cover page when you preview or share your tour. In this case, replace the video with a great looking image.
Yes. You can use standard HTML tags to format the text in your captions and also add hyperlinks. For example, this Map Tour uses HTML tags to format the caption text and add a hyperlink to a website. If you add hyperlinks, be sure to use the target="blank" parameter so that your target link opens in a new tab, so your readers can return to your tour by closing that tab without losing their place. See this blog post about adding HTML formatting and links to Story Map Tour captions. You can also use HTML tags to format the title and subtitle of a Map Tour.
For security reasons, ArcGIS only allows a specific set of HTML tags to be used. In the Story Map Tour Builder if you add unsupported HTML tags into the tour title, names or captions, you'll either see the tags simply appear as text, or the builder may give you the error message "Save failed due to an invalid html tag in a name or description" when you press Save (in which case you'll need to remove the unsupported tag in order to save). Here is the standard list of supported HTML. Story Map Tour also supports the hr tag to get a horizontal ruler line in a caption. like in the example above. However note that if you are using the option to upload images into the Story Map Tour, there are additional restrictions on the supported HTML you can use in a tour because that option uses a feature service. For feature services see this standard list of supported HTML. The hr tag is not supported in Map Tours that use uploaded images, however you can use a div tag set to style="border-top:1px solid #000" to get a horizontal ruler (supported in Side Panel layout only).
Yes. If you download and self-host the Story Map Tour app you can customize the marker symbols. You'll find them in the resources/markers folder in the source code. You only need to add new icons for the colors you want to use.
Yes. If you download and self-host the Story Map Tour app you can customize the app to show more than 99 points. See this section in the Story Map Tour GitHub repository. We don't recommend having more than 99 points in a tour, though, because that is a lot to expect your audience to view. One approach would be to divide your large Map Tour into several smaller, more focused tours that your audience can choose from.
Yes. There are two options for this.
You can download a CSV file defining the Map Tour field schema from the Advanced Options in the Map Tour Builder Welcome dialog when you first launch the Story Map Tour Builder to create a new tour. You can also access that CSV file template here. You can use that template to assemble your places in a spreadsheet or table, export that as a CSV file, and then upload it into the Advanced Options dialog using the 'Import Tour Data from a CSV file' button. This option is a useful way to create tours from data already in spreadsheets or tables, or that you export from your GIS. It requires that your images are referenced via URLs, because those URLs are stored as values in the CSV file. For this reason you can't use this option if you want to upload images directly into your tour.
You can also create a data layer that uses the set of fields that the Map Tour expects, add it to an ArcGIS web map, open that web map, and then share it by creating a Story Map Tour. The Map Tour Builder will recognize your layer and use it to define the tour. This layer uses the same field schema defined in the CSV file mentioned in the previous paragraph. Images have to be referenced via URLs. Your layer can be based on a CSV file, shapefile or feature service. For example you can create your layer in ArcGIS Desktop and then publish it as a feature service. Shapefiles aren't recommended because of their 254 character maximum width for text fields. Make sure there is no scale visibility range defined for the layer in your web map, otherwise your Map Tour may fail to load. The layer needs to be visible at all scales in the web map to work in Map Tour. For more information about Map Tour data storage options, see this section in the Story Map Tour GitHub repository
The new Side Panel layout doesn't display thumbnails, but thumbnails still have to be specified if you author a Side Panel Map Tour using a CSV file or a layer in a web map. So you still need to use the Map Tour field schema that has fields for the main image and the thumbnail image for each point.
You can embed your Map Tour in an iframe:
<iframe width="100%" height="800px" src="Your App URL" frameborder="0" scrolling="no"></iframe>
Make your embedded tour as large as possible on the page to maximize ease of use. We also recommend including a link on the page near the embed so that people can launch your Map Tour in full-screen mode if they want to explore in more depth. This also makes it easier for mobile users to fill their screen with your tour. You can preview your embed in My Stories.
If you want to embed your Map Tour without its header, you can append an &embed parameter to the end of your tour's URL:
https://story.maps.arcgis.com/apps/MapTour/?appid=d5b2c90d8a53466f9c3efb0f25d13325&embed
In the April 2018 update to ArcGIS Online, we introduced a new layout option, called Side Panel, into the Story Map Tour. So in addition to the two original layout options: Three Panel and Integrated, you now have a third choice when deciding what you want your Map Tour to look like.
For a visual comparison of the three layout options now available in Story Map Tour, see the Map Tour overview page.
The Side Panel layout provides a fresh new look for Map Tours. There's a lot more space in the layout for your images, so this new layout makes your photos really shine. There's an optional cover page, which lets you fill the screen with a great image to grab the attention of readers before they dive into your tour. The Side Panel layout has a separate scrollable area for your captions that doesn't overlap your images. There's a new set of colorful map markers, and an improved viewing experience on mobile devices and small displays.
When you create a new Map Tour you can choose to use the new Side Panel layout or one of the two original layouts. To choose the layout for a Map Tour, click the Settings button in the builder and in the dialog that appears, make your choice in the Layout tab. When you author a Side Panel Map Tour, you'll notice a new look for the builder that makes it easy to assemble your tour. The builder buttons, like Save, Share and Organize, are in a panel on the left.
In order to give your images and narrative captions the maximum space on screen, the Side Panel layout doesn't have a thumbnail carousel along the bottom. Another difference between the side panel layout and the original Three Panel and Integrated layouts is that in the Side Panel layout, images always fill the available screen space, the same way that the Fill option for images in the Story Map Series and Story Map Journal templates makes them fill the available space. This makes the images look great but does mean that they will get cropped in some displays, depending on the shape of your image and the size and shape of the reader's web browser window. This is different from how images are displayed in the original Map Tour layouts, where they are always shown in full without being cropped. Images that you don't want to appear cropped, like infographics or images with text or important elements on the left and right sides, are not therefore not recommended in the Side Panel layout. However don't forget that in all three layouts, readers can hover over the image in your tour and click the expansion control that appears in the upper right of the image to open it in a separate window in full with no cropping. When a Side Panel tour is viewed on a small display or mobile device, the images are fit into the available space and are not cropped.
When viewing a Side Panel story map, the reader can click the title in the header to start over from the beginning. Also, in the Three Panel and Integrated layouts, the currently selected place is shown with a black popup. In the Side Panel layout, we automatically center the map on the currently selected place and make the symbol larger: there's no black popup showing the currently selected place.
If you use videos in your Side Panel Map Tour, you currently can't play the videos within the builder. However the videos can be played when you preview or open your tour.
An attractive and compelling feature of the new Side Panel layout in Story Map Tour is the optional cover page. This lets you grab your audience's attention with a great looking, full-screen image. By default, when you create a new Side Panel Map Tour, the cover page option is turned off. To configure the cover page for a Side Panel Map Tour, first add some or all of your tour points into your tour. Then click the Organize button, and in the dialog that appears make sure that the tour point that you want to use to define the cover page is the first point in your tour. Then simply click the 'Use the first point as a cover page' box in that dialog. The name used for your first tour point will become the title shown in the middle of the cover page, the caption for that point will become the subtitle underneath that title, and that point's image will used as the cover page image. The title in the black header at the top of a Side Panel Map Tour is the actual title you specified for the tour. As the author, you could choose to make the title in the middle of the cover page the same as the title in the header of the tour, or take advantage of the ability to use different text for each.
You don't see the Side Panel cover page shown full-screen in the Map Tour Builder. Instead in the builder we show it as a place in the tour, so you can make edits to it. To see how your cover page will look to your readers, simply preview or open your tour. Note that in the Side Panel layout you can't use a video as the cover page. The Map Tour Builder will let you save a Side Panel Map Tour with a video as the cover media, but that video won't appear in the cover page when you preview or open the tour. In that case, replace the video with a great looking image.
The cover page option is not available for the original Three Panel and Integrated layouts.
Yes. To change an existing Map Tour to use the new Side Panel layout, click the Settings button, and in the dialog that appears choose that layout from the Layout tab. You can also switch your Map Tour back to its original layout if you change your mind.
If you switch an existing Map Tour to use the Side Panel layout, and that tour has an 'intro' tour point defined (via the check box in the Organize dialog), then your Side Panel tour will automatically have a cover page. This is because the side panel layout uses that intro option to define the cover page. If you don't want a cover page for your Side Panel tour, click the Organize button, and in the dialog that appears, uncheck the 'Use the first point as a cover page' option.
If your existing Map Tour has a subtitle in its header, that subtitle is not displayed in the Side Panel layout's black header. By design, the Side Panel header only shows the title of the tour. To present your readers with a subtitle, you can use that text in your Side Panel's cover page by editing the caption of the first point in your tour so it uses your desired subtitle text.
Colors you have specified in the Settings dialog's Colors tab are not used in the Side Panel layout. You'll notice that in the Settings dialog, the Colors tab is disabled when you work on a Side Panel map tour. This is because these colors don't apply to the Side Panel layout.
If you switch an existing Map Tour to use the Side Panel layout with a cover page enabled, and your tour uses a zoom-level (set via the Settings dialog's Zoom Level tab), then when your readers start your tour they'll see the first place in the tour on the map displayed at that specified zoom level. Your readers will only see the extent of your tour (the extent set in the Settings dialog's Extent tab) if they click the Home button in the map. This is the expected behavior. In the Three Panel and Integrated layouts, when a zoom level is being used, the extent of your tour is shown on the map when your tour launches, and then the zoom-level kicks in when the reader advances to the first point in the tour.
In order to give your images and narrative captions the maximum space on screen, the new Side Panel layout doesn't have a thumbnail carousel along the bottom. However, the Side Panel Map Tour uses the same data schema as the original Three Panel and Integrated layouts, and does require that thumbnails are defined, even though they aren't displayed in the Side Panel layout. This is so that you can switch a Side Panel tour to use one of the other layouts if you want to. If you are using the most common workflows for authoring a Map Tour, that is, uploading images directly into the builder or using existing images from Flickr, the Map Tour builder automatically generates thumbnails for you, irrespective of which layout you are using. If you author a Side Panel Map Tour by uploading a CSV file into the builder, or by publishing a web map that contains a layer which uses that data schema, there does still need to be a field defining the thumbnail images for your places. If you add places to a Side Panel tour using the Add dialog and pasting in the URLs of images, you still need to provide the URLs to a main image and to a thumbnail image.
Yes. See these blog posts for more tips and tricks about Story Map Tour.
Yes. Highlight the text you want to convert to a link, then in the Story Actions section of the Side Panel toolbar, click the 'Navigate to a section' button. You'll be prompted to choose the section in your Journal you want the link to navigate your readers to.
Story actions are also supported in Story Map Series.
In the Story Map Journal Builder, we've provided some great default colors to get you started. If you are using an account on an ArcGIS Organization, your administrator can also specify a set of custom colors as a "shared theme" that will be used by the Story Map Journal and Story Map Series apps. If you want to customize the colors even further, you can download and self-host the application. See this section in the Story Map Journal GitHub repository.
Story Map Journal has been enhanced to improve accessibility so that the widest possible range of people can read Map Journal content. Map Journals can be navigated using the keyboard and also support assistive technologies like screen readers. Map Journal authors can add alternate text for all media including images, videos, maps and web maps in the "main stage" or narrative panel. For more about adding alternative text to your Story Map Journal to improve accessibility, see this blog post.
When you open a Story Map Journal you can use these keys to navigate through the sections: Up/Down Arrows, Page Up/Page Down, Space bar. You can press Tab to navigate through the interactive elements in a Map Journal, such as buttons and links. As you tab through, each element is shown with a highlight to indicate that it is selected. Shift+Tab navigates through the interactive elements in the opposite direction. Press Enter to activate the currently selected button or link.
Several hidden buttons are revealed when you use Tab to navigate with the keyboard. These buttons let you easily jump between parts of the story:
When you use Tab to navigate around a Map Journal, you’ll see a link appear in the narrative panel in each section that lets you send keyboard focus to the main stage in the Journal. When the main stage contains a map and you give the map keyboard focus, you can use the Arrow keys to pan the map, and the + and - keys to zoom in and out. To return focus to the narrative panel from the map, press the Esc key.
If you are using an assistive technology such as VoiceOver you can use landmarks to jump between functional areas of the story map. The following areas have ARIA landmark roles:
For more about Story Map Journal accessibility, see this blog post.
Given the choice, in your Map Journal we recommend that you use a small number of web maps, each containing many layers, instead of a large number of web maps with a few layers each. You can then configure each section in your journal to display the appropriate layers from that small set of maps, instead of having a separate web map for each journal section. Each web map makes a call to the server when it is opened, which means that the more maps your Map Journal has, the more round trips to the server need to be made. On the other hand, you may not find it convenient to author all your content in a small number of maps, so choose what works best for your project.
Story actions are links you can add into your Story Map Journal's side panel or floating panel text that your readers can click to change what's shown on the main stage. For example you can define a story action that your readers can click that will zoom in on the map in the main stage, toggle a layer on or off in that map, display a pop-up for a particular place, or all of the above at once! You can also define story actions that jump to a different section in your journal. They greatly extend the storytelling capabilities of the Map Journal. See this blog post for more details. It is also possible to create story actions that appear as buttons instead of links: see this blog post.
Story actions are also supported in Story Map Series.
In general we recommend landscape orientation (i.e. images that are wider than they are tall) instead of portrait orientation.
If you upload your images directly into your Map Journal, those images are automatically optimized and managed for you to give the best performance, so you can use an image of any size and it will load quickly in your story. Similarly if you use images stored in Flickr or Google+/Picasa, Map Journal will take advantage of optimizations in how these services store your photos, so your images will also load quickly.
If you reference your images on the web directly via URL links make sure the images aren't too large. Images shouldn't exceed 800 KB but you should target 400 KB or less for most images. The recommended image widths are:
We also recommend using JPG format and saving your images at 80% image quality to reduce file size. Large images referenced via URLs that slow down performance may seem to load quickly to you. This is because after you've displayed them once during the authoring process, they are cached in your web browser. However they'll seem slow to people viewing your story. If you are not able to resize your images for best performance, we don't recommend referencing them via URLs, and you should upload them into your Map Journal instead.
If you reference images on the web directly via URLs, make sure these URLs start with HTTPS not HTTP. Avoid adding images (or any other content) that can't be referenced via HTTPS. This will give your readers the best experience when they view your story map because it will help ensure that your story is fully compliant with HTTPS, and therefore prevent web browsers warning your readers that your story is potentially insecure. See this FAQ question above for more info on web security and Story Map content.
Yes. See these blog posts for more tips and tricks about Story Map Journal.
In general we recommend landscape orientation (i.e. images that are wider than they are tall) instead of portrait orientation.
If you upload your images directly into your Cascade those images are automatically optimized and managed for you to give the best performance, so you can use an image of any size and it will load quickly in your story. Similarly if you use images stored in Flickr or Google+/Picasa, Cascade will take advantage of optimizations in how these services store your photos, so your images will also load quickly.
If you reference your images on the web directly via URL links make sure the images aren't too large. Images shouldn't exceed 800 KB but you should target 400 KB or less for most images. The recommended image widths are:
We also recommend using JPG format and saving your images at 80% image quality to reduce file size. Large images referenced via URLs that slow down performance may seem to load quickly to you. This is because after you've displayed them once during the authoring process, they are cached in your web browser. However they'll seem slow to people viewing your story. If you are not able to resize your images for best performance, we don't recommend referencing them via URLs, and you should upload them into your Cascade instead.
If you reference images on the web directly via URLs, make sure these URLs start with HTTPS not HTTP. Avoid adding images (or any other content) that can't be referenced via HTTPS. This will give your readers the best experience when they view your story map because it will help ensure that your story is fully compliant with HTTPS, and therefore prevent web browsers warning your readers that your story is potentially insecure. See this FAQ question above for more info on web security and Story Map content.
Yes. Like the other Story Map apps, Cascades automatically respond to the smaller screen sizes on mobile devices so they can be read easily. Some media that can be added into Cascades doesn't work on mobile devices. 3D web scenes don't work on mobile. Videos work on mobile with one exception: if you use a video as the media for the cover page, that video won't work on mobile. In these cases, the Cascade Builder allows you to specify an image as alternate media that will be automatically displayed instead when your Cascade is viewed on mobile. For media that won't work on mobile, if you don't specify alternate media, the Cascade Builder's Health Report will warn you by displaying an orange strip next to the media in question. You can also take advantage of the alternate media option to further optimize your Cascade for mobile use by replacing media that may not work well on mobile. For example, web maps in Cascades are supported on mobile, but maps with a lot of layers or that require a lot of interaction in your story may not work well for your readers using mobile devices. In these cases you can, optionally, specify images as alternate media instead.
The alternate media feature was added to Cascade Builder in the ArcGIS Online release at the end of June 2017. We recommend that you edit your existing Cascades to specify alternate media for any content that won't work on mobile, or won't work well, to ensure the best experience for your readers. See this blog post for more info.
Yes. See our Cascade tips blog post. Then browse these other blog posts for more tips and tricks about Story Map Cascade.
And be sure not to miss these 'How to Cascade' interactive guides, created using Cascade by Esri Story Maps team member John Nelson.
The maximum number of entries in a Story Map Series is 30. It is possible to increase this limit if you download the Story Map Series app and customize the source code. See this GeoNet question for details.
In general we recommend landscape orientation (i.e. images that are wider than they are tall) instead of portrait orientation.
If you upload your images directly into your Map Series, those images are automatically optimized and managed for you to give the best performance, so you can use an image of any size and it will load quickly in your story. Similarly if you use images stored in Flickr or Google+/Picasa, Map Series will take advantage of optimizations in how these services store your photos, so your images will also load quickly.
If you reference your images on the web directly via URL links make sure the images aren't too large. Images shouldn't exceed 800 KB but you should target 400 KB or less for most images. The recommended image widths are:
We also recommend using JPG format and saving your images at 80% image quality to reduce file size. Large images referenced via URLs that slow down performance may seem to load quickly to you. This is because after you've displayed them once during the authoring process, they are cached in your web browser. However they'll seem slow to people viewing your story. If you are not able to resize your images for best performance, we don't recommend referencing them via URLs, and you should upload them into your Map Series instead.
If you reference images on the web directly via URLs, make sure these URLs start with HTTPS not HTTP. Avoid adding images (or any other content) that can't be referenced via HTTPS. This will give your readers the best experience when they view your story map because it will help ensure that your story is fully compliant with HTTPS, and therefore prevent web browsers warning your readers that your story is potentially insecure. See this FAQ question above for more info on web security and Story Map content.
Yes. See these blog posts for more tips and tricks about Story Map Series.
Story Map Shortlist came out of beta in the June 2018 update to ArcGIS Online, and is now a fully supported storytelling app template.
It is currently not planned to make Shortlist available in ArcGIS Enterprise. If you need to deploy Shortlist on your ArcGIS Enterprise Portal you can download the code from Github, host it on your Enterprise Portal, and add it as an item to your Enterprise Portal Configurable App Gallery.
Story Map Shortlists can't be authored on Microsoft Edge, but they can be viewed in that browser. For viewing or authoring Story Map Shortlists on Windows 10 we don't recommend Internet Explorer: there's currently a technical issue that sometimes causes an incorrect screen refresh. This is not an issue with Internet Explorer on Windows 7.
When you author a Shortlist in the Builder, you can define places without giving them an image or specifying their location. This enables you to enter your set of places first, and then locate them and give them images later. Any places that don't have names, images, or that have not been located yet on the map, are automatically omitted from the Shortlist your readers see. If a place is missing on your Shortlist, make sure it has been located on the map in the Builder, has been given a name, and it has both a thumbnail image and a main image.
Also, by default, the Shortlist tabs only show your readers the places in the current map area they are viewing. In the Shortlist Builder however, the tabs show you all the places in your Shortlist, irrespective of the current map area, to make the authoring process easier. If a place is missing on your Shortlist, it may be because it is located outside the default map location that your readers see when your Shortlist opens. (Note that you also have the option, via the Settings dialog, to specify that your Shortlist tabs will show your readers all the places, not just the places in the current map area).
Yes. In ArcGIS Online, open the web map used in your existing Shortlist, share it as a web application, and choose Story Map Shortlist from the application gallery. You'll be prompted to choose the layer or layers in your web map that contain your Shortlist places. Those places can be imported into the Shortlist Builder where you can configure your new Shortlist and perform any further edits and updates to your places interactively. For example in the Builder you can assign larger images to your places to take full advantage of the new look of the Shortlist app. When you create a new Shortlist by importing places from your web map, your original Shortlist app is unaffected because the Shortlist Builder automatically copies your imported places into a new web map. An option for your new Shortlist to reference the places in your original web map rather than import them is also available. With this option your new Shortlist will reflect on-going changes to your data in your web map. This is useful if you want to do your place editing and management in your map using ArcGIS mapping and editing tools, instead of in the Shortlist Builder. However this requires that all your places are in a single feature layer in your web map, not one layer per tab, and that there are two fields in that layer referencing images via URLs for each place: one for the thumbnail image and one for the main image.
Yes, you can create a Shortlist using existing point feature data in an ArcGIS Online web map. To create your Shortlist using point data in an existing web map, first go to ArcGIS Online and open that web map. Then share it as a web application and choose Story Map Shortlist from the application gallery. The Shortlist Builder will open and prompt you to select the point data you want to use.
You have two options. The simplest option is to import your points into the Shortlist Builder as places. In the Builder you can then add images and descriptive text to the places, organize them into tabs, delete and add places, etc. When you use the import option, the Shortlist Builder automatically copies your imported places into a new web map, so your original point data and web map are unaffected by any further changes you make to the places in the Builder. This option works with any point data in feature layers and doesn't require that your point data uses a particular set of fields or data 'schema'. You can choose which attributes in your data you want to display in the description for your places.
You also have the option for your Shortlist to reference the places in your original web map rather than import them into the Builder. This is the 'as-is' option. With this option your Shortlist will reflect on-going changes to the data in your web map. This is useful if you want to do your place editing and management in your map using ArcGIS mapping and editing tools instead of in the Shortlist Builder. The Shortlist Builder will display the places but won't let you edit or organize them, nor add or change images. This option requires that your point data uses the particular set of fields ('schema') expected by the Shortlist. You can download this schema from the dialog that appears when you create a Shortlist from a web map containing point data, or here. This schema requires that all your places are in one feature layer in your map and that there are two fields referencing images via URLs for each place: one for the thumbnail image and one for the main image. If you use this 'as-is' option, be sure to read the question below about recommended image sizes for images referenced by URL.
Yes. The release of the new hosted version of the Story Map Shortlist application does not affect existing Shortlists deployed using the original, non-hosted version of the app. If you have deployed a Shortlist using the original version of the app, the code for your Shortlist is hosted on your own website or webserver, and so is unaffected by the new release. The source code for the original version of the Shortlist (version 1.x) is still available for download from the Story Map Shortlist GitHub repository.
You can use images of any size and shape in a Story Map Shortlist, but we recommend landscape orientation (i.e. images that are wider than they are tall) instead of portrait orientation. Shortlists generally look best if all the images have the same size and aspect ratio, so your readers don't get distracted by differently shaped images as they browse your places. The recommended image aspect ratio is 4:3.
If you upload your images directly into your Shortlist, those images are automatically optimized and managed for you to give the best performance, so you can use an image of any size and it will load quickly in your story. Similarly if you use images stored in Flickr or Google+/Picasa, Shortlist will take advantage of optimizations in how these services store your photos, so you can use an image of any size and it will load quickly in your story.
If you reference images on the web directly via URLs, the file size of each image should ideally be less than 400 KB. Images that are larger than that can slow down performance. We recommend using JPG format and saving your images at 80% image quality to reduce file size. Shortlist images referenced by URLs don't need to be larger than 1000 pixels wide by 750 pixels tall, so resizing larger images to those dimensions can reduce their file size, but you don't need to resize your images if they are already 400 KB or less. If you reference images by URLs, avoid using the same image for the main image and the thumbnail image. This can really slow down performance as your tabs load. You should ideally point at smaller images for the thumbnails. For thumbnail images referenced by URLs we recommend a size and shape of 280 pixels wide by 210 pixels tall. That thumbnail shape (aspect ratio of 4:3) fits exactly into the Shortlist thumbnail area and so won't get cropped.
Remember that large images referenced via URLs that slow down performance may seem to load quickly to you. This is because after you've displayed them once during the authoring process, they are cached in your web browser. However they'll seem slow to people viewing your Shortlist. If you are not able to reduce the file size of your images for best performance, we don't recommend referencing them via URLs, and you should upload them into your Shortlist instead. Note that if you use the option to create your Shortlist from a point layer in a web map and use those points 'as is' to define your places (as opposed to importing them into your Shortlist so they can be given images in the Builder) then you have to reference your images via URLs stored as attributes in that layer.
If you reference images on the web directly via URLs, make sure these URLs start with HTTPS not HTTP. Avoid adding images (or any other content) that can't be referenced via HTTPS. This will give your readers the best experience when they view your story map because it will help ensure that your story is fully compliant with HTTPS, and therefore prevent web browsers warning your readers that your story is potentially insecure. See this FAQ question above for more info on web security and Story Map content.
Every Shortlist has an associated web map which contains the places shown in the Shortlist. For example, if you create a Shortlist 'from scratch' the Shortlist will automatically create a web map for you in which the places you define will be stored. You can also create a Shortlist from an existing web map by sharing the map in ArcGIS Online. If you create a Shortlist from a web map that contains point data, and you choose to import that data into the Shortlist as places that you can edit in the Shortlist Builder, the Shortlist automatically makes a copy of your web map and uses that copy to store your places. You can edit the web map associated with a Shortlist in order to add supporting layers into your Shortlist to provide additional information on the map that your readers see. For example, if your Shortlist is about hiking trails you can add those hiking trails into the web map as line features. Or you could add a layer representing a study area boundary, and so on. The symbology and popups you define for the supporting layers you add are displayed in the Shortlist, so be sure to configure the popups for feature layers you add if you want your readers to be able to click on them to get more information. Turn popups off for layers you add that you don't want people to be able to click on. To edit the web map used in your Shortlist, first close the Shortlist Builder if you currently have it open. This is important because you can lose data if you try and edit a Shortlist's web map while you are also editing that Shortlist in the Builder. Then go to the My Stories section of the Story Maps website, find your Shortlist, click the Maps tab and then click the Edit Map button.
Important note: If you edit the web map used by a Shortlist you must not edit the point layer in the web map in which the Shortlist stores the places. This layer is normally called 'Shortlist layer'. Do not attempt to edit this layer in order to add, delete or modify the places in your Shortlist. This can result in loss of data because this layer is stored in the Shortlist's own format. The only exception to this is if you use the 'as-is' option to create your Shortlist. With the 'as-is' option, you define all the places for your Shortlist in a point layer in a web map, and the Shortlist simply displays those places 'as-is'. This enables you to manage and maintain your places in the web map instead of being able to edit them interactively in the Shortlist Builder. When you use this option, editing the places in the web map is the only way you can update your Shortlist. If you want to manage your places by editing a layer in a web map, use the 'as-is' option. See this FAQ question above for more info on the 'as-is' option.
Yes. See these blog posts for more tips and tricks about Story Map Shortlist.
Yes, you can embed a Swipe story in Story Map Journal, Story Map Series or Story Map Cascade. (Note that Cascade does have a transition option for views in an immersive section that can give you a similar effect to Swipe, which may be a better alternative than embedding a Swipe app). You can add the &embed parameter to the end of the URL to the Swipe app you embed to hide the header of the Swipe app. This gives your embedded app more space and eliminates duplication of header elements like the title and logo. For example if you embed a Swipe app in a Story Map Journal, you can use the narrative text in the Map Journal side panel to describe what the Swipe is showing instead of displaying the Swipe app's header.
See this blog post and this blog post for more info and tips about embedding web content into your story map.
Story Map Basic is useful if your map speaks for itself and doesn't need additional narrative. As the title and subtitle in the header are the only descriptive text your readers will see, take time to write them carefully. You could also embed a Story Map Basic app in a web page if your web page contains the narrative or supporting media you want to present along with the map. When you create a Story Map Basic app, the focus is very much on the map, so make sure your popups are configured in the web map, and that the symbology and the legend look good.