> For the complete documentation index, see [llms.txt](https://docs.talentmap.com/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.talentmap.com/knowledge-base/step-7-communicate-and-take-action/action-planning-in-compass/action-planning-setup.md).

# Action Planning Setup

## Action Planning setup

Setup is where HR administrators configure Action Planning for their organization, including the reporting structure, user assignments, Guidance content, and data import/export.

{% hint style="info" %}
**Beta feature.** Action Planning is currently available as a beta release. Features and interface details may change as we refine the experience.
{% endhint %}

{% hint style="info" %}
**Admin access required.** Only HR Admin, Org Admin, and TalentMap Consultant roles can access Setup.
{% endhint %}

***

### Structure tab

The Structure tab configures how the reporting structure tree is built from your participant data.

#### Mode options

* **Level of Authority** — Builds the tree from hierarchical field values (for example, Division > Department > Team). Select fields in order from highest to lowest level.
* **Reports To** — Builds the tree from a direct reporting relationship field.

#### Building the structure

1. Navigate to **Actions** > **Setup** > **Structure**.
2. Select your preferred mode.
3. Click **+ ADD LEVEL** to add additional hierarchy levels (if using Level of Authority mode).
4. Click **GENERATE STRUCTURE** to create the tree.

<figure><img src="/files/0m5Ez8PMvFIemy63tIzv" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Re-importing a structure.** When rebuilding an existing structure, groups matched by email keep their action plans. Plans attached to removed nodes move to a "Review" group at the root for administrator review and reassignment.
{% endhint %}

***

### Users tab

The Users tab assigns Compass users to reporting structure nodes.

{% hint style="info" %}
**Structure required first.** This tab is locked until a reporting structure is configured in the Structure tab.
{% endhint %}

{% hint style="info" %}
**When to assign users.** You only need to assign users if you want managers and executives to log in to Compass and create, manage, and monitor their own action plans. If your HR team will manage all action plans centrally, you can skip this step.&#x20;
{% endhint %}

1. Navigate to **Actions** > **Setup** > **Users**.
2. Upload a file with user names, user emails and field values. Column A must contain the users name and column B must contain user emails. Remaining columns must contain field names matching the tree structure from your participant information file.&#x20;

{% file src="/files/jVftdMHU7fJWFgvY0HwM" %}

<figure><img src="/files/bDlk1ctolYPzyqYSSRVW" alt=""><figcaption></figcaption></figure>

3. Select an upload option: **Add to existing assignments** or **Replace all existing assignments**.
4. Click **Upload**.

Accepted file formats: .csv, .xlsx

<figure><img src="/files/hwM2B5nvNa1Pk3x1zV0W" alt=""><figcaption></figcaption></figure>

***

### Guidance tab

The Guidance tab is where you write the step-by-step instructions managers see when they enter Action Planning.

1. Navigate to **Actions** > **Setup** > **Guidance**.
2. Click **EDITING** to enter edit mode.
3. Add or update each numbered step with a title and rich-text description.
4. Click the checkmark to save.

You can reference specific action plan templates by name, link to the Results page, and customize language to match your organization.

<figure><img src="/files/TKQ9xIBYN6n5LdB1B1Lp" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Keep guidance focused.** 4-6 steps work best for manager engagement.
{% endhint %}

***

### Import/Export tab

#### Exporting action plans

1. Navigate to **Actions** > **Setup** > **Import/Export**.
2. Click **Export Action Plans**.

Compass downloads an Excel spreadsheet containing the reporting structure, plan names, descriptions, statuses, and milestones.

#### Importing action plans

1. Navigate to **Actions** > **Setup** > **Import/Export**.
2. Upload an Excel or CSV file matching the export format. The file should include tree level columns, an "Action Plan" column, a "Description" column, and milestones if present.
3. Select an import option:
   * **Add to existing action plans** — Imports new plans without changing existing ones.
   * **Replace all existing action plans** — Deletes all existing plans and imports from the file.

{% hint style="info" %}
**Replace is permanent.** The "Replace all existing action plans" option cannot be undone. Always export your current plans as a backup before using this option. {% endhint %}
{% endhint %}

<figure><img src="/files/TzxITFj0LEFMRr8r0HhT" alt=""><figcaption></figcaption></figure>


---

# 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://docs.talentmap.com/knowledge-base/step-7-communicate-and-take-action/action-planning-in-compass/action-planning-setup.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.