> For the complete documentation index, see [llms.txt](https://everyday-digital.gitbook.io/authoring-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://everyday-digital.gitbook.io/authoring-docs/content-pages/content-page-library/activity-guide.md).

# Activity Guide

## What is an Activity Guide?

Use an Activity Guide if you want to provide your users with instructions on how to complete specific interactions, including: dragging & dropping, selecting & matching, or swiping.

## Quick steps: how to create & edit an Activity Guide

1. **Open Authoring.** Create or open a [Learning Story](/authoring-docs/authoring/content-types/learning-story.md), [Assessment](/authoring-docs/authoring/content-types/assessment.md) or [Survey](/authoring-docs/authoring/content-types/survey.md) [content type](/authoring-docs/authoring/content-types.md).
2. **Add or open a Story, Assessment or Survey.** Open the Editor.
3. **Add an Activity Guide and place it directly in front of a** [**Drag & Drop**](/authoring-docs/content-pages/content-page-library/drag-+-drop.md)**,** [**Memory Game**](/authoring-docs/content-pages/content-page-library/memory-game.md) **or** [**Swipe Card**](/authoring-docs/content-pages/content-page-library/swipe-card.md) **page.** Select the + icon and choose Activity Guide from the Add Page options.&#x20;
4. **Update the Activity Guide page to edit.** Select the page to view the [Page Options](/authoring-docs/content-pages/story-and-page-settings.md#what-are-the-page-options), and select Update to add and edit text.&#x20;
5. **Choose a Guide Type and customise.** You can customise the colour, heading and text instructions (optional).&#x20;

## Activity Guide Type, Options & Custom Text

### Guide Type & Options

**Guide Type**\
Select the Guide Type you would like to add:

* Dragging & Placing Guide,&#x20;
* Selecting & Matching Guide, or&#x20;
* Swiping Guide.

**Highlight Colour**\
The guides are presented in grayscale and will make use of one highlight colour. Select an alternative if you do not wish to use the theme default.

### Custom Text (Optional)

**If you do not add custom text, the default Guide Activity instructions will be used.**

**Heading**\
Each guide is presented with custom text (to see this text, simply save the page).

**Guide Text**\
If you wish to write your own copy, you can enter a heading and some text in the spaces provided.


---

# 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:

```
GET https://everyday-digital.gitbook.io/authoring-docs/content-pages/content-page-library/activity-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
