---
title: "User guide"
canonical: "https://support.appfire.com/space/ME/289476830/User%20guide"
format: markdown
---
> Macro (aura-html)

> ⚠️ If you plan to migrate to the Cloud, ensure you do not lose your data/configurations. Check out the [Migration guide](https://appfire.atlassian.net/wiki/x/9QhLEQ) for information on how to migrate the app’s data to Cloud. Contact our [support team](https://appfire.atlassian.net/servicedesk/customer/portal/11) if you have any questions.

# User guide 

The MultiExcerpt function is a two-step process involving both macros:

1. Creating the MultiExcerpt key - the text you want to multiply and display in various locations.
2. Inserting the MultiExcerpt Include to display the key text.

## Create the MultiExcerpt key 

1. Select the MultiExcerpt macro.

2. Name the MultiExcerpt, then click **Insert**.

3. The MultiExcerpt key is displayed on the page.

4. Add the text you want to display inside the MultiExcerpt macro body in multiple locations.

##  Insert the MultiExcerpt Include Macro

1. Select the MultiExcerpt Include macro. To include the MultiExcerpt inline with the current content, select **MultiExcerpt Fast Include (Inline)**. Or, select **MultiExcerpt Fast Include (Block)** to insert the content as a resizable block.
  
2. Add where the MultiExcerpt key is located (**Space** and **Page**) and its **Name**, then click **Insert**.
  
3. The MultiExcerpt Include block displays while the Confluence page is in edit mode. In view mode, your text displays exactly how it looks in the MultiExcerpt key.

## Using the @self keyword for the Page with Excerpt parameter

The **@self** feature is helpful in page templates employing the MultiExcerpt-Include macro. It allows you to incorporate a MultiExcerpt from the template directly. Subsequently, when representing pages using that template, the MultiExcerpt-Include seamlessly operates without modifying the page title within the **Page with Excerpt** parameter.

![MultiExcerpt user guide showing macro configuration example](media://c9280433-4690-4b7b-93c8-7891b66d0c5f)

When creating a new page, and you include both MultiExcerpt and a MultiExcerpt-Include at the same time. Before you published the page, you might notice that the drop-down menu for selecting a **MultiExcerpt Name **in** **the **MultiExcerpt-Include** menu doesn't show any names. This happens because the system can't see the new page yet since it has not been published.

Here's what you can do:

- If you're adding the MultiExcerpt-Include in the first version of the page (version 0), you can manually type the name of the MultiExcerpt in the **MultiExcerpt Name **box.
- Alternatively, you can add the MultiExcerpt, publish the page, and then go back to edit it. When you add the MultiExcerpt-Include, the drop-down will show the names because the page has been published.

The system can't see a MultiExcerpt you just added until the page is published. So, either type it in manually when adding or publish the page first and then add it to see the drop-down names.

## Find MultiExcerpt Includes 

You can search for all the locations where a specific MultiExcerpt has been included.

1. Navigate to the page where the MultiExcerpt is located.
2. Click **Edit** (page edit mode) to view the MultiExcerpt macro.
3. Click the MultiExcerpt macro.
4. Click **Find includes - this space/Find includes - selected space**.
  
5. The list of pages that include MultiExcerpt are listed. Click any link to go to that page.