Best practices for customizing classic Esri Story Maps

Here on the Story Maps Developers’ Corner, we share a lot of tips and techniques about customizing story maps for people who know a little code as well as expert web developers.

If you are closely following any of the techniques we’ve published here on the Developers’ Corner, your customizations are safe. We make every effort to make sure stories customized in these ways continue to work.

However, if you’re going off-script you’ll want to make sure you follow the guidelines below to make sure your customizations are safe and your stories won’t break in future Story Map template updates.

If you are adding HTML in a Story Map builder to customize a story map that’s hosted on ArcGIS Online, be sure to read our article on using HTML:

Only some HTML tags and attributes are approved for use in stories that are hosted on ArcGIS Online. The article above contains a list of approved HTML. If a tag or attribute is not specifically listed in this list, you should not use it.

An experienced developer might find information in a browser’s dev tools to use for customizations. But if you are using HTML to customize a story map that’s hosted on ArcGIS Online, make sure your customizations do not use any internal methods or code. In other words, don’t reference application code that is not documented. This includes methods used by the story map application code or from internal libraries or dependencies (e.g., Bootstrap).

As mentioned above, a good rule of thumb is that if you are using any of the techniques in our published blog articles, those customizations are safe. Making other types of modifications brings you into risky territory.

By self-hosting, you assume any risk for your customizations and you control when you update the Story Map template code. Before merging in updates from a new release, you can test them with your custom code. If the update affects your customizations, you can modify them before updating or choose not to update the code.

For instructions on hosting your own story map, check out this article:

Related posts:

Extracting date information from text is a common task in Natural Language Processing (NLP) that can be achieved using a variety of techniques: DateMatcher and MultiDateMatcher are rule-based…

Education is characterized as an important human value, a must-have of a society, basis of a well-qualified life and flourishing future conditions. Education is an essential tool for combination of…

To be eligible for MBBS study at Fergana Medical Institute of Public Health, you need to fulfill certain criteria, including: Academic Qualifications: Applicants should have completed their higher…