# Available Document Template Placeholders

Source: https://docs.astalty.com.au/guide/document-template-placeholders

> The placeholders you can drop into a Word document for Astalty to fill in automatically.

Add a Template Placeholder wherever a generated document should use information from Astalty, such as a Participant's name or your organisation's details. When you generate the document, Astalty replaces the Placeholder with the matching value.

The template's [Usage Type](https://docs.astalty.com.au/guide/settings/template-settings#template-usage-types) determines which Placeholders are available. The lists below are grouped into **Participant**, **Service Agreement**, and **User** templates.

> **Click to copy**
>
> Select any placeholder in the tables below to copy it to your clipboard, ready to paste into your template.

> **Contact placeholders match the relationship exactly**
>
> The **Representatives & contacts** Placeholders use the Participant Contact whose [relationship](https://docs.astalty.com.au/guide/participants/participant-directory/contacts#relationship) is recorded as *Primary Contact*, *Emergency Contact*, *Plan Nominee*, or *Child Representative*. The wording must match exactly. For example, *Child Rep* will not match *Child Representative*.
>
> If no active Contact matches, the generated document leaves the related Placeholders blank. If more than one active Contact has the same relationship, Astalty uses one of them. Check the generated document before you send or finalise it.
>
> Each relationship also has a **Consent To Share Information** Placeholder, such as `${Participant_PrimaryContact_ConsentToShare}`. It uses the matching Contact's [consent to share information](https://docs.astalty.com.au/guide/participants/participant-directory/contacts#consent) setting and shows **Yes**, **No**, or **Not set**. It is blank when there is no matching Contact. The [Contacts menu](https://docs.astalty.com.au/guide/participants/templates/custom-templates#adding-a-contact-to-a-generated-template) in a generated document shows the same choice as **Consent to share given** or **Consent to share not given**.

> **Two ways to bring Goals into a document**
>
> **Participant Goals** adds each Goal name as a bulleted list. **Participant Goals Table** adds one row per Goal. Both include Goals that are **In Progress** and not archived. [Using Goals in Document Templates](https://docs.astalty.com.au/guide/participants/goals#using-goals-in-document-templates) explains the columns in the table.

## Information Item Placeholders

Participant and Service Agreement templates can use your account's Participant [Information Items](https://docs.astalty.com.au/guide/settings/participants-settings#information-items). Each Information Item Placeholder fills with the detail recorded for that Participant. It is blank when no detail is recorded.

- They only work in an **Astalty Template**, not a Word document.
- Insert them from the Placeholder list in the template editor. Typing the displayed Placeholder text by hand will not connect it to the Information Item.
- They are specific to your account, so they do not appear in the general list below.
- Renaming an Information Item updates the placeholder in your templates. If an Information Item is deleted, its placeholder generates as blank.

## Primary Coordinator Placeholders

The **Primary Coordinator** placeholders read the Participant's Primary Coordinator. If the Participant has none, they are left blank.

## All Placeholders

The list below is generated from the Placeholders currently available in Astalty.

The current list of placeholders loads live on the web page, from <https://api.app.astalty.com.au/v2/document-placeholders>.
