Configure story settings—ArcGIS StoryMaps

Learn how to customize a story using the story settings.

Display options

Display options help you customize your readers' experience.

Display

You can remove the button that allows readers to share a story on social media by enabling Hide sharing options.

Note:

This option only applies to stories that are shared publicly.

Enable Hide cover to keep the story's cover from displaying when viewing the story.

Note:

When you hide the story's cover, the story cannot be indexed by search engines. Because of this, using this advanced setting is only recommended when a story won't be widely shared.

You can specify whether and how the date is displayed on the story cover using the Date on cover setting.

Story language

Setting a language in Story settings ensures that the story broadcasts the correct language in web browsers. This is recommended and ensures that browser translation tools and assistive technologies, such as screen readers, work as expected. Some languages may also require a number and date format to be set.

Unless customized, the story language is set to your ArcGIS profile language.

Note:

Your ArcGIS profile determines the language used in the story builder. When writing a story in a different language, it's recommended that you change your ArcGIS profile to the language in which you are writing.

Translations (beta)

You can link translated versions of a story in the story settings on the Translations tab. This allows readers to easily switch between language versions.

Analytics

Analytics is the collection of metrics related to published stories. As an author, adding analytics tracking to a story will provide insight into your audience and how they engage with your content.

Demographic metrics, such as location and language preferences, can inform decisions about how you tell your story and what key points to highlight to ensure that your story has the greatest impact. In addition, you have access to other metrics, such as how many people saw your story, how long they stayed on the page, and what kind of devices they used. You can gain these insights using Google Analytics or Adobe Analytics with your stories.

Note:

Adding analytics to a story is only available to authors with organizational accounts on ArcGIS Online. For more information about account options, see Licensing.

Note:

When using ArcGIS StoryMaps on ArcGIS Online, adding analytics tracking is only available if your organization is participating in the Esri User Experience Improvement (EUEI) program. For more information about the EUEI program and how to configure it, see Configure general settings. A story author can write a consent message for stories that use analytics to inform readers of the anonymous tracking and require them to opt in to it. Stories that already have Google Analytics configured before July 14, 2021, will continue to track analytics even if the organization is not participating in the EUEI program; however, the story author or an administrator can remove the tracking from a story at any time using Story settings.

Add Google Analytics

To add Google Analytics to a story, complete the following steps:

Get a Google Analytics ID. For more information about creating a property in Google Analytics and finding your Google Analytics ID, see Set up the Analytics Google tag in the Google Analytics help.
For more information about creating a property in Google Analytics and getting your Google Analytics ID, see Set up the Analytics Google tag in the Google Analytics help.
In the story builder, click the menu button .
Click Story settings to open the Story settings menu.
On the Analytics tab, turn on the Enable Analytics toggle button, and choose Google Analytics. Add the Google Analytics ID in the Tracking ID field, optionally write a consent message in the Consent message field, and click Save.
Add the Google Analytics ID in the Tracking ID field, optionally write a consent message in the Consent message field, and click Save.

The Google Analytics ID is added to the story. Google Analytics records metrics for published stories that you can access on the Google Analytics website.

Add Adobe Analytics

To add Adobe Analytics to a story, complete the following steps:

Create a report suite in Adobe Analytics. For more information on creating a report suite, see Adobe Analytics: Create a report suite.
For more information about creating a report suite, see Adobe Analytics: Create a report suite.
Configure the suite to capture the Adobe events correctly. Use the mappings for Adobe Analytics in the Report Suite Manager, included at the bottom of this page.
In the story builder, click the menu button .
Click Story settings to open the Story settings menu.
On the Analytics tab, turn on the Enable Analytics toggle button, and choose Adobe Analytics. Add the Report suite ID and Tracking server details. For more information on where to find your report suite ID and tracking server, see Adobe Analytics: How to identify your analytics tracking server and report suites ID. Optionally, write Consent message text and click Save.
Add the Report suite ID and Tracking server details.
For more information about where to find your report suite ID and tracking server, see Adobe Analytics: How to identify your analytics tracking server and report suites ID.
Optionally, write Consent message text, and click Save.

Adobe Analytics is configured for use with the story. Adobe Analytics records metrics for published stories that can be accessed on the Adobe Analytics Report Suite Manager.

Report Suite Manager mappings


Property	Name
prop1	eventType
prop2	referrer
prop3	hostname
prop4	path
prop5	pageName
prop6	previousPageName
prop7	previousPageUrl
prop8	category
prop9	action
prop10	label
prop11	attribute
prop12	details

Enable advanced embedding

Developers can customize and style a story by enabling the advanced embedding features of ArcGIS StoryMaps. Using this capability, you can embed a story in a web page hosted on your domain and use HTML, CSS, and JavaScript code to change a story's appearance and functionality.

Note:

This feature is currently only available on ArcGIS Online.

To enable advanced embedding, complete the following steps:

On the Advanced tab of the Story settings menu, click Enable advanced embedding.
In the text box under Allowed domains, provide the name of the domain where you plan to embed the story, for example, www.example.com. Do not include a protocol or port number.
Do not include a protocol or port number.
Click Add.
Repeat the steps above to add more domains if needed.
Publish the story.
A story must be shared with everyone to be embedded in another website.

Once the story is published, you can obtain the code snippet needed to embed the story in your website by viewing the published story, clicking Share, and choosing Script (advanced) from the drop-down menu. The code snippet is a <script> tag similar to the following:

Feedback on this topic?