> For the complete documentation index, see [llms.txt](https://bcds.gitbook.io/learn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bcds.gitbook.io/learn/tutorials/storytelling/introduction-to-arcgis-story-maps/using-content-blocks.md).

# Using Content Blocks

StoryMaps provides a number of content block styles to choose from. Please note that public ArcGIS accounts do not have the embed, audio, and image gallery available.&#x20;

* [View this StoryMap](https://arcg.is/aqOmi0) for a demonstration of the different kinds of content blocks.&#x20;

## Adding a New Content Block

To add a new content block, click in the area just above or below an existing content block.  (The plus sign is automatically there when first launching a new story.) It will look like the following:

![](/files/-MWUlSzznIMm61L_qfcY)

You will see the various content block and element options:

![](/files/-MWUlV3zp4lbojfD8lwi)

## Content Block Types

Below are descriptions of the different content blocks with links to instructions created by ArcGIS. They are organized as "Basic," "Media," and "Immersive," which is how they are organized in Story Maps.

### Basic

![](/files/-MWUlJzK9z68-NaUHJHh)

* **Text** - a text block for general textual content, headers, bullet point, lists, quotes, etc.
* **Button** - adds a button that can be linked to outside sources.
* **Separator** - adds a line to break up content on the page, used to make content more readable and navigable&#x20;

ArcGIS instructions:

* See [Add narrative text](https://doc.arcgis.com/en/arcgis-storymaps/author-and-share/add-narrative-text.htm)

### Media

![](/files/-MWUlHVB0-iBuPRZ9kRO)

* **Map** - create "express maps" in Story Maps or bring in ArcGIS map
* **Image** - upload or link to images
* **Image gallery\*** - create an image gallery in the form of a grid of images
* **Video** - upload or link to videos
* **Audio\*** - upload or embed sound clips
* **Embed\*** - embed different types of media (e.g., a TimelineJS timeline or a 360 degree photograph)
* **Swipe** - create a swiping effect between two images or online maps &#x20;

\**Not available with the free version.*

ArcGIS instructions:

* See ArcGIS's [Getting started with ArcGIS StoryMaps](https://storymaps.arcgis.com/stories/cea22a609a1d4cccb8d54c650b595bc4) sections: "Building a Narrative," "Add an Embed," and "Make a Map"
* Also, see: [Add maps](https://doc.arcgis.com/en/arcgis-storymaps/author-and-share/add-maps.htm), [Add media](https://doc.arcgis.com/en/arcgis-storymaps/author-and-share/add-media.htm), and [Add swipe blocks](https://doc.arcgis.com/en/arcgis-storymaps/author-and-share/add-swipes.htm)

### Immersive

![](/files/-MWUlBv7JJiQlw7iipBW)

* **Slideshow** - create a more traditional slideshow
* **Sidecar** - create a moving side panel for text and media independent of the main panel, also allows for text blocks to overlay and move across media
* **Map tour** - create an interactive map that combines images, text with a map

*Note that the Slideshow option has been incorporated into the Sidecar layouts.*

ArcGIS instructions:

* See ArcGIS's [Getting started with ArcGIS StoryMaps](https://storymaps.arcgis.com/stories/cea22a609a1d4cccb8d54c650b595bc4) sections: "Add Immersives"
* Also see, [Add sidecars](https://doc.arcgis.com/en/arcgis-storymaps/author-and-share/add-sidecars.htm), [Add slideshows](https://doc.arcgis.com/en/arcgis-storymaps/author-and-share/add-slideshows.htm), [Add map tours](https://doc.arcgis.com/en/arcgis-storymaps/author-and-share/add-guided-tours.htm)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://bcds.gitbook.io/learn/tutorials/storytelling/introduction-to-arcgis-story-maps/using-content-blocks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
