Add media

Multimedia content makes a story more visually engaging and extends the impact of narrative text. There are three types of media content blocks: image, video, and embed.

Note:

If you are using ArcGIS StoryMaps in an ArcGIS Enterprise environment that is not connected to the internet, linked media and online content are not available.

Add images and videos

You can add images and videos to the story or collection from a local file or a web link. You can add them in the story cover, the body of a story, and immersive content blocks. Streaming video platforms, such as YouTube and Vimeo, are supported. For more information about the file types and sizes that you can use, see Frequently asked questions.

Use the following steps to add an image or video:

1. Click the open button to open the block palette.
2. Select Image or Video.
3. Upload or link to an image or video file.
   • To upload an image or video file from your computer, drag a file to the Upload tab or click the Browse your files button to browse your files.

     Note:

     You can also reuse previously added images.

   • To link to an image or video from the internet, go to the Link tab and provide the URL.

The image or video is added to the story or collection.

Add image galleries

You can add an image gallery in the body of a story by uploading images from local files or from a web link. You can use this block to showcase a set of related photos, and each gallery supports a maximum of 12 images. You can choose from three layout options: Jigsaw, Dynamic squares, or Filmstrip. For more information about the file types and sizes that you can use, see Frequently asked questions.

Note:

Image galleries are not available by default for ArcGIS StoryMaps on ArcGIS Enterprise. To enable them, the portal administrator must select Show beta features from Organization settings.

Use the following steps to add an image gallery:

1. Click the open button to open the block palette.
2. Select Image gallery.
3. Upload images from local files and click Create gallery.

The image gallery is added to the story.

Note:

You can add more images to the image gallery after it is created by clicking the Add media button on the toolbar. In this way, you can add linked images to a gallery.

Add timelines

You can add a timeline to illustrate a series of chronological events. You can choose from three layout options: Waterfall, Single side, and Condensed. You can add the time or date, description, and an image for each event in the timeline block. You can reorder the events in the timeline and also add or delete events in the block. You can add a spacer to indicate extended periods of time between the events.

Use the following steps to add a timeline:

1. Click the open button to open the block palette.
2. Select Timeline.
3. Choose a timeline layout: Waterfall, Single side, or Condensed.

   A timeline with two events is added in the story.

   Note:

   You can change the layout at any point in the authoring process from the Options menu in the timeline.

4. Add time or date, description, and an image for each event in the timeline. Continue adding events as needed.

The timeline is added to the story.

Configure images and videos

The media configuration toolbar appears when you hover over images and videos. From the toolbar, you can edit images, change the size and placement of media, add attribution and alternative text details, or replace the media. You can choose whether to allow readers to expand the image, and to fit the image to the screen, from the image options. A thumbnail image is automatically generated and stored for all uploaded videos. The thumbnail image is shown initially for videos that are set to click-to-play or if the video cannot be loaded. You can replace the thumbnail from the video options.

Note:

Depending on its original size, you can resize the media frame to be small, medium, or large. Medium images must be at least 1,200 pixels wide, and large images must be at least 1,920 pixels wide. The float option offsets the media to the side and allows text wrapping around it.

Edit images (beta)

You can crop and mark up images using the image editor. Open the image editor by hovering over an uploaded image and clicking Edit.

On the Crop tab, you can alter the dimensions of your image. Drag the corners of the resizing box that appears over the image to crop it. You can use the menus to apply a preset shape or aspect ratio to the cropped image. To reorient your image, use the Rotate and Flip buttons.

Click Markup to show the image markup controls. From the toolbar, you can add various elements, including colored pins, numbered points, lines, shapes, and arrows. Use the Scale button to change the size and thickness of the markup elements on your image.

After applying edits, click Save to apply the changes and close the image editor.

Replace media

Replacing images and videos is supported for inline images and videos as well as for immersive blocks such as sidecar, slideshow, and map tour. Swipe, image gallery, and timeline blocks support replacing images.

Use the following steps to replace an image or a video:

1. Hover over the media to open the editing toolbar.
2. Click the More options menu.
3. Click the Replace image or Replace video button (depending on the media type).
4. Replace the media by adding a new upload or link and click Replace.

The image or video is replaced and retains the same size and caption of the previously added media.

Add attribution

You can add attribution for uploaded and linked images and uploaded videos. Embedded videos from third-party providers have summaries, descriptions, and attribution that readers can view on the provider's website from a link available in the provider's embedded video player.

Use the following steps to add attribution to images and videos:

1. Hover over the media to open the editing toolbar.
2. On the editing toolbar, click the Options button.
3. Provide the attribution information in the Attribution field and click Save.

Attribution is added to the image or video as an icon in the upper corner of the media.

Add alternative text

Adding alternative (alt) text is required for all images and videos to provide support for search engines and readers using assistive technologies.

Use the following steps to add alt text to media:

1. Hover over the media to open the editing toolbar.
2. On the editing toolbar, click the Options button.
3. Click Accessibility, enter alternative text that describes the media in the Alternative text field, and click Save.

The alternative text is added to the picture or video.

Add closed captions

Closed captions improve accessibility by overlaying text on a video that narrates spoken dialogue and describes nonverbal audio elements, such as sound effects and music.

Use the following steps to add closed captions to a video:

1. Hover over the media to open the editing toolbar.
2. On the editing toolbar, click the Options button.
3. Click Accessibility, and click the Upload closed captions button.
4. In the file picker, select your WebVTT (.vtt) file that has been configured for your uploaded video.
5. Once the file is uploaded, click Save.

The closed captions are added as an option to your video.

Configure video playback

You can configure the playback settings for uploaded videos that have been added to the main body of a story, in all map tour layouts, and in the media panel of the sidecar's docked layout.

Use the following steps to configure video playback:

1. Hover over the video to open the editing toolbar.
2. On the editing toolbar, click the Options button.
3. On the Playback tab, select one of the playback options: Click to play, Autoplay without controls, or Autoplay with controls.

The selected playback option is applied to the video in the story.

Add embeds

You can add a wide variety of online content, such as web apps, dashboards, social media posts, and websites, to a story using the Embed block. When you embed online content, the story builder inspects the content and displays it as either interactive content or an embed card. Typically, the content is added as a card, a reliable reader-friendly format that opens the online content in a new browser tab when clicked. Some types of online content are added directly as interactive content, an embed block in the story that contains live web content. You can change the formatting of embedded online content to fit the content and your story.

Note:

In addition to embedded content and embed cards, you can also link to external online content by adding a button or a hyperlink to your story narrative. For more information, see Add narrative text.

Use the following steps to add online content:

1. Click the open button to open the block palette.
2. Select Embed.
3. Provide the URL to the online content and click Save.

The online content is added to the story.

Note:

When embedding content in a story, it is recommended that you use a web page or app from a public website that does not require a login. Content on a private network or content that is protected by a login may work under certain conditions. For example, web pages on a private network only work when the reader is connected to that network. Websites that require a login may work in some cases as a live embed, but the story builder will not be able to fetch card details from these sites. Additionally, many websites and apps that require a login restrict embedding as an added security precaution.

Formatting tips for embedded content

Consider the following when formatting embedded content:

• You can change the embed format by hovering over the embedded content and selecting the embed card or interactive embed format from the embed editing toolbar.

  Note:

  Some web content does not support embedding and will not display in the interactive embed format.

• For interactive embedded content, click the Options button to open the Embed options pane and configure the large-screen or small-screen appearance. For large screens, you can choose whether to include a button on the embed to open live content in a new tab, and whether to hide the Click anywhere to interact overlay on the embed that allows readers to directly interact with the embed. For small screens, you can customize the card details. From Properties, you can add alternative text and copy the embedded content reference URL.
• For embed cards, click the Options button to open the Card options pane and customize the card details and copy the embedded content reference URL.
• On mobile devices, all embedded online content is displayed as cards.

Add offline media for embeds

When creating a briefing, you can add offline media for embeds (and maps) to improve the experience for readers who download the briefing using the ArcGIS StoryMaps Briefings mobile app. When a briefing is downloaded, the offline media is downloaded with the rest of the briefing content and shown when the reader accesses the briefing from the device without a network connection.

Use the following steps to add offline media to an embed:

1. Hover over the embed to show the editing toolbar.
2. On the toolbar, click Options.
3. On the Offline tab, select the type of offline media you want to add. Choose Image or Video, or provide a URL or embed code.
4. Choose the package, image, or video and click Save.

The offline media is added.

Add audio

You can add audio to the story from a local file or embed it using a link or embed code from an audio hosting service. You can add audio in the body of the main story and in sidecar narrative panels. Hosted audio platforms, such as SoundCloud, are supported by the Embed content block option. For more information about the file types and sizes that you can use, see Frequently asked questions.

Use the following steps to add audio:

1. Click the open button to open the block palette.
2. Select Audio.
3. Upload an audio file or provide a URL or embed code.
   • To upload an audio file from your computer, drag a file to the Upload tab or click the Browse your files button to browse your files.
   • To embed audio from the internet, go to the Embed tab and provide the URL or embed code.

     Note:

     The Embed option does not support links to audio files on a web server. This option is for embedding audio from audio hosting services.

The audio is added to the story.

Note:

You can change the size and placement of the audio player in the story using the editing toolbar, which appears when you hover over media. For uploaded audio, you can resize the media to be small, medium, or float. The float option offsets the audio to the side and allows text wrapping around it.