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

Images and videos can be added to the story from a local file or a web link. These can be added 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 can be used, see Frequently asked questions.

Use the following steps to add an image or video:

  1. Click the open button Open block palette 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.
    • 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.

Add image galleries

An image gallery can be added in the body of a story by uploading images from local files. This block can be used to showcase a set of related photos, and each gallery supports a maximum of 12 images. You can choose from two layout options: Jigsaw or Dynamic squares. For more information about the file types and sizes that can be used, see Frequently asked questions.

Use the following steps to add an image gallery:

  1. Click the open button Open block palette 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.

Edit images and videos with the toolbar

The editing toolbar appears when you hover over images and videos. From the editing toolbar, you can 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 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 1200 pixels wide, and large images must be at least 1920 pixels wide. The float option offsets the media to the side and allows text wrapping around it.

Replace media

Replacing images and videos is supported for inline images and videos as well as for immersive blocks such as sidecar, slideshow, and guided tour. Swipe 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 then click Replace.

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

Add attribution

Attribution can be added for images and videos in the story cover and in immersive content blocks. You can add attribution for uploaded and linked images and for uploaded videos.

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 recommended 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 Properties, 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.

Configure video playback

You can configure the playback settings for uploaded videos that have been added to the main body of a story.

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. The formatting of embedded online content can be changed 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 Open block palette 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 best to 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 adjust the small screen appearance, customize the card details, 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 audio

Audio can be added to the story from a local file or embedded using a link or embed code from an audio hosting service. Audio can be added 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 can be used, see Frequently asked questions.

Use the following steps to add audio:

  1. Click the open button Open block palette 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.