# Template Settings

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

> Add custom document templates that use Astalty placeholders to auto-fill your paperwork.

Astalty Premium - This feature is part of the Astalty Premium plan. See What Premium includes.

> **Looking for everything on Templates?**
>
> The [Templates](https://docs.astalty.com.au/guide/templates) landing page brings together Participant, User, and NDIA templates, plus how to set templates up in the first place.

## Overview

Custom Templates turn your organisation's standard paperwork into reusable Astalty documents. Placeholders fill business, Participant, service agreement or team member details when you generate a document.

By default, only Admins can view and manage templates. User Templates also need the User Document Templates feature and the **Can manage HR details for users** permission (see [Updating Roles and Permissions](https://docs.astalty.com.au/guide/roles-and-permissions)).

![The Custom Document Templates page, reached by selecting Settings in the main menu, marked 1, then Templates in the settings menu, marked 2. Each template lists its Status, Name, Description, Usage and Type.](https://docs.astalty.com.au/assets/templates-settings-1-1770099135.png)

## Creation Process

Open [**Settings > Templates**](https://app.astalty.com.au/settings/templates), then select **Create a Template**.

![The Custom Document Templates page, with the Create a Template button in the top right highlighted and an arrow pointing to it.](https://docs.astalty.com.au/assets/create-a-template-1.png)

The form opens with a **Want a head start?** card offering to **Browse the library** - a set of pre-written templates you can import and then edit as your own, covered in the [Document Template Library](https://docs.astalty.com.au/guide/settings/document-template-library). Below it, a divider reading *or start from scratch below* leads into the form described here.

Enter a name and description, choose the usage type, then select an Astalty Template or Word Template.

The same sections appear when you come back to edit the Template later - **Details**, **Template Usage**, and **Template Format** - each covered below.

![The Edit Document Template drawer for Community Access Service Agreement, with the Details, Template Usage and Template Format sections. Usage shows Service Agreement Template and Template Format shows Astalty Template, both greyed out.](https://docs.astalty.com.au/assets/template-settings-edit-document-template-details.png)

> **Usage and Format are locked after creation**
>
> **Name** and **Description** can be changed at any time, but **Usage** and **Template Format** are only editable while you are creating the Template. Once it has been created both fields are greyed out, so choose them carefully - to switch a Template to a different Usage or Format you will need to create a new one.

## Template Usage Types

The usage type controls which placeholders are available:

- **Participant Template** - This Template allows you to use the following placeholder groups;
  - Business
  - Participant
  - Primary Coordinator
  - Formatting
- **Service Agreement Template** - This Template allows you to use the following placeholder groups;
  - Business
  - Participant
  - Primary Coordinator
  - Service Agreement
  - Formatting
- **User Template** - This Template allows you to use the following placeholder groups;
  - Business
  - User
  - Formatting

![The Add Document Template drawer with the Template Usage section highlighted and the Usage dropdown open, listing Participant Template, Service Agreement Template and User Template, with User Template selected.](https://docs.astalty.com.au/assets/user-templates.png)

## Template Format

### Astalty Template Vs Word Template

Choose an **Astalty Template** to build and edit the content in Astalty with placeholders.

Using a Word Template lets you upload a `.docx` file whose placeholders are filled when a document is generated. Add the supported placeholders to the Word file before uploading it, because they cannot be inserted from Astalty's editor. Generated Word documents can then be downloaded and completed in Microsoft Word.

![The Add Document Template drawer with the Template Format section highlighted and its dropdown open, offering Astalty Template and Word Document.](https://docs.astalty.com.au/assets/t3.png)

For a Word Template, insert the required placeholders in the Word document before uploading it. See [Document Template Placeholders](https://docs.astalty.com.au/guide/document-template-placeholders).

![A Word document table showing participant details with Astalty placeholders such as ${Participant\_FullName}, ${Participant\_NDISNumber}, and ${Participant\_DateOfBirth} entered into the value cells.](https://docs.astalty.com.au/assets/template-settings-word-document-placeholders.png)

## Content Screen

Select **Create**. For an Astalty Template, select **Update Template Content** to open the editor.

![A new Provider Document Template named Photo and Media Consent with the Type Astalty Template, and an arrow pointing to the Update Template Content button in the empty Content panel.](https://docs.astalty.com.au/assets/create-template-2.png)

For a Word Template, the content screen lets you download the uploaded Word document.

![A Provider Document Template named Medication Assistance Consent with the Type Word, showing Duplicate and Edit buttons, a Download button on the Content panel and a note that Word documents are best viewed in Microsoft Word or Google Docs.](https://docs.astalty.com.au/assets/create-template-3.png)

## Write an Astalty Template with Ask Astalty

> **AI Document Template Builder is in beta**
>
> This beta is enabled per account by Astalty. It also requires an AI seat and permission to update Provider Document Templates. If **Write with AI** does not appear on an active Astalty Template, [contact Astalty support](https://docs.astalty.com.au/guide/getting-help) to ask whether the beta is enabled for your organisation.

Ask Astalty can draft a new template, rewrite part or all of its content, add placeholders and change the template's name, description, front page, contents page, body text size, header or footer. It cannot change the Usage or Template Format after the template is created.

To work on an existing template:

1. Open [**Settings > Templates**](https://app.astalty.com.au/settings/templates) and select an active Astalty Template.
2. Select **Update Template Content**.
3. Select **Write with AI** in the editor.
4. Describe the document or change you need. The template stays beside the chat and refreshes as Ask Astalty works.
5. Review the approval card before replacing existing template content. Changes to settings such as the name or layout take effect immediately.

You can keep editing the template by hand. Ask Astalty reads the latest saved version before a later change, so it keeps work you did not ask it to replace.

You can also open **Ask Astalty** and ask it to create a document template from a description. Specify the name and usage in your request. Ask Astalty creates the template immediately and you can review it beside the chat. Select **Open in editor** to continue in Template Settings.

AI template work uses the seat holder's [included AI usage](https://docs.astalty.com.au/guide/users/ai-and-mcp-access#see-your-included-ai-usage).

## Document Layout

Astalty Templates print with a front page by default, carrying your logo and the document's title, and can also include a contents page, a repeating header and footer, and page numbers. These options sit in the **Front Page**, **Body**, and **Header & Footer** sections of the template's Edit screen. Turn the front page off for a short form that should start straight on its content.

![The Front Page section of the template form with the Include a front page checkbox highlighted and unticked, above the Include a contents page checkbox](https://docs.astalty.com.au/assets/template-settings-document-layout-front-page-options-guide.png)

See [Document Layout](https://docs.astalty.com.au/guide/settings/template-settings/document-layout) for what each option does, and for how the settings are captured at the moment a document is generated.

> **Astalty Templates only**
>
> Layout options only appear for **Astalty Templates**. **Word Templates** print exactly as the uploaded Word document is set up.

## Template Content - Placeholders

The editor shows the sections available for the Template's usage type.

Astalty Placeholders and fields that you can enter into your Astalty Template will pull information from within your Astalty Account. Some examples of placeholders include NDIS Number, Participant Name, Primary Coordinator Name, and Schedule of Supports.

See [Document Template Placeholders](https://docs.astalty.com.au/guide/document-template-placeholders) for the full list.

> **Tables in template content**
>
> The Template editor builds tables too, and can shade their cells, align the text inside them, merge and split cells, and turn header rows and columns on and off - see [Formatting Tables](https://docs.astalty.com.au/guide/templates/formatting-tables).

> **Images in template content**
>
> The Template editor can also add pictures, such as charts, diagrams and photos, then resize them and give them alt text - see [Adding Images](https://docs.astalty.com.au/guide/templates/images).

### Participant Template

If you selected the Participant Template, this is what you would see.

![The template Content editor for a Participant Template, with the placeholder groups Business, Participant, Primary Coordinator and Formatting highlighted below the formatting toolbar.](https://docs.astalty.com.au/assets/participant-template-1.png)

### Service Agreement Template

If you selected the Service Agreement Template, this is what you would see.

![The Content editor of a Service Agreement template in Templates settings, with the placeholder buttons Business, Participant, Primary Coordinator, Service Agreement and Formatting highlighted above the agreement text.](https://docs.astalty.com.au/assets/service-agreement-template-1.png)

### User Template

If you selected the User Template, this is what you would see.

![The template Content editor for a User Template, with the placeholder groups Business, User and Formatting highlighted below the formatting toolbar.](https://docs.astalty.com.au/assets/user-template-1.png)

## Completed Astalty Custom Template Example

Once you have added your information from any existing organisational documentation or if you created the information from scratch and added it into Astalty, the Template screen would look like this below.

![The completed Community Access Service Agreement template, with the Type Astalty Template, its layout summary such as Front Page Left aligned with a Medium logo, and a Content panel of agreement wording containing highlighted placeholders such as Participant\_FullName and Business\_Name.](https://docs.astalty.com.au/assets/custom-template-example.png)

## How to edit a Custom Template

Select an Astalty Template under **Settings > Templates** to edit it.

![The Custom Document Templates list in Settings, with an arrow pointing to the Employment Agreement row, an Astalty Template, to open it.](https://docs.astalty.com.au/assets/edit-template-1.png)

Once within the entry, select **Edit** on the **Content** card to open the text editor.

![The Employment Agreement template, a User Template with the Type Astalty Template, with the Edit button on its Content panel highlighted and an arrow pointing to it.](https://docs.astalty.com.au/assets/edit-template-2.png)

For Word Document template types you will need to download the template and edit the document in Word prior to re-uploading with the changes.

## Front Page

An Astalty Template opens with a front page carrying your business logo and a title, by default. The **Front Page** section of the Template form controls whether that page appears, what it says and how it looks, and whether a contents page follows it.

1. Open the Template from [Template Settings](https://app.astalty.com.au/settings/templates).
2. On the **Provider Document Template** card, select **Edit**.
3. Adjust the settings under **Front Page**.
4. Save your changes.

![The Front Page section of the Document Template form with the Include a front page checkbox highlighted and ticked, showing the Document Title field, Front Page Alignment set to Left aligned and Logo Size set to Medium, above the Include a contents page checkbox](https://docs.astalty.com.au/assets/template-settings-front-page-settings-guide.png)

You can set all of these while creating a Template, rather than coming back to edit them afterwards.

### Include a front page

Tick **Include a front page** (on by default) to open the document with the front page described above. Turn it off for a short form that should start straight on its content:

- No cover page, no logo, no title - the document opens directly on its content.
- **Document Title**, **Front Page Alignment** and **Logo Size** drop off the form, because they only apply to the front page.
- The header, footer and page numbers (see [Header and Footer](#header-and-footer)) start on the first page of your actual content - page 1, or page 2 when a contents page is included - instead of being left off a front page that no longer exists.
- A document still in **Draft** shows its draft date at the top of the first page of content, rather than on the front page.

### Document Title

Only shown while **Include a front page** is on. The title on the front page is the Template's name, unless you give the Template its own **Document Title**.

Leave **Document Title** blank to use the Template name on the front page. You can instead use a detailed Template name, such as *Community Access Service Agreement 2026*, while giving the generated document a shorter title, such as *Service Agreement*.

### Front Page Alignment

Only shown while **Include a front page** is on. Sets where the logo and title sit on the front page:

- **Left aligned** - the default. The logo and title sit against the left margin.
- **Centred** - the logo and title are centred across the page.

### Logo Size

Only shown while **Include a front page** is on. Controls how large your business logo is printed on the front page - **Small**, **Medium** (the default), or **Large**. If your logo is detailed or includes text alongside the icon, a larger size keeps it legible; a simple mark usually looks better small.

> **Upload a logo first**
>
> The front page only shows a logo if one has been uploaded to your account, so **Logo Size** has no visible effect until then. Add yours under **Business Logo** in [Business Settings](https://docs.astalty.com.au/guide/settings/business-settings).

### Include a contents page

Tick **Include a contents page** to add a page listing every heading in the Template, in order, on its own page straight after the front page - or as the first page, if the front page is off. It's off by default, and is worth turning on for longer documents such as a full Service Agreement.

The list is built from the headings in your Template content, down to three levels deep, and each entry links to its section in the PDF. A Template with no headings won't produce a contents page even with the setting turned on - so if your contents page comes out missing, check that your content uses headings rather than bold text.

Ticking the box reveals a second option, **Number the contents entries**, which adds *1*, *1.1*, *1.1.1* style section numbers to the list. Leave it off if your headings already carry their own numbering, or you'll end up with numbers twice.

> **Astalty Templates only**
>
> The **Front Page** settings only appear on **Astalty Templates**. A **Word Template** carries whatever front page you have built into the Word document itself.

> **Existing documents keep their original front page**
>
> Each generated document keeps the presentation settings it was created with. Changing a Template's **Front Page** settings only affects documents generated from that point on - anything already generated keeps the front page, title, alignment, logo size, and contents page it was produced with.

Your **Front Page** settings carry through to every document generated from the Template, the blank PDF you download from the **Actions** menu, and the on-screen **Preview**.

## Body

**Body Text Size** sets how large the Template's own content is printed in the generated document - **Small** (the default), **Medium**, or **Large**. Bumping it up is an easy way to make a document easier to read for a Participant who prefers larger print, without editing the Template content itself.

![The Body and Header & Footer sections of the Document Template form, showing Body Text Size set to Small, the empty Header and Footer fields with their Insert placeholder buttons, and Header Alignment and Footer Alignment set to Left aligned](https://docs.astalty.com.au/assets/template-settings-body-header-footer.png)

## Header and Footer

The **Header & Footer** section adds text that repeats on every page of the generated document. Type into **Header**, **Footer**, or both, and leave a field blank to leave it off entirely.

- **Header Alignment** and **Footer Alignment** each offer **Left aligned**, **Centred**, or **Right aligned**.
- Press **Enter** for a new line if you want details stacked over several lines.

To include a business detail such as your business name or ABN, either select **Insert placeholder** above the field and pick from the list, or type **$** in the field itself to bring up the same list. Either way the detail fills in automatically when the document is generated, so it stays right if your business details change later.

Page numbers are always printed in the footer as *Page 1 of 4*, and they sit opposite your footer text - so they move to the left when the footer is right aligned. With no footer text, the page number sits on the right on its own.

> **The front page and contents page stay clean**
>
> Header text, footer text, and page numbers are all left off the front page (when there is one) and the contents page. With a front page, they start on page 2 - or page 3 when a contents page is included too. With no front page, they start on page 1 - or page 2 when a contents page is included.

## Preview, Download, or Duplicate a Template

When viewing an **Astalty Template** with content, the **Actions** menu in the top right gives you three ways to work with it:

- **Preview** - opens a quick on-screen preview of the template's layout.
- **Download blank template** - downloads an empty PDF of the template without selecting a Participant.
- **Duplicate** - creates a copy of the Template that you can edit without changing the original.

![The Community Access Service Agreement template with the Actions menu open, offering Preview, Download blank template and Duplicate.](https://docs.astalty.com.au/assets/template-settings-download-blank-actions.png)

The blank PDF keeps the template's wording, headings, and page breaks, but leaves every Placeholder in the content unfilled - each one is shown as a plain label in square brackets (for example `[Participant Full Name]` or `[Business Name]`) instead of being replaced with a Participant's details. A [header or footer](https://docs.astalty.com.au/guide/settings/template-settings/document-layout#header--footer) still shows your business details.

![Page 2 of a blank template PDF, with the agreement wording kept and each placeholder shown as a label in square brackets, such as Participant Full Name and Business Name.](https://docs.astalty.com.au/assets/template-settings-download-blank-output.png)

Previewing or downloading a blank copy is handy for checking a template's structure, or for producing a paper copy to print and fill in by hand - no Participant required.

> **Preview and blank downloads need an Astalty Template with content**
>
> **Preview** and **Download blank template** only appear on **Astalty Templates** that already have content. For **Word Templates**, use the **Download** button on the Content card to download the uploaded Word document instead. **Duplicate** works on every Template, covered next.

## Duplicating a Template

Select **Duplicate** to start a new Template from an existing one instead of building it from scratch. It copies the name, description, usage, format and content into a new Template that you can then edit freely without changing the original.

- On an **Astalty Template with content**, **Duplicate** is the third option in the **Actions** menu, alongside Preview and Download blank template.
- On a **Word Template**, or an Astalty Template with no content yet, there is no **Actions** menu - **Duplicate** is its own button next to **Edit**.

Confirm in the dialog that opens, and Astalty takes you straight to the copy with a **Template duplicated** toast.

![A Provider Document Template named Community Access Service Agreement (2), with a Template duplicated toast reading You're now viewing Community Access Service Agreement (2).](https://docs.astalty.com.au/assets/template-settings-duplicate-toast.png)

### Naming the Copy

The copy's name adds a number in parentheses to the original's, such as *Community Access Service Agreement (2)*. If that name is already taken, Astalty keeps counting up until it finds one that's free - so duplicating the same Template several times gives you *(2)*, then *(3)*, then *(4)*, and so on.

Duplicating a copy numbers from the original name rather than nesting the count, so duplicating *Community Access Service Agreement (2)* gives you *Community Access Service Agreement (3)*, not *Community Access Service Agreement (2) (2)*.

> **A name that already ends in brackets**
>
> Astalty only reads a trailing number in brackets as a copy count when a Template with the un-numbered name also exists. A Template genuinely named *Plan (2025)* duplicates to *Plan (2025) (2)*, not *Plan (2026)*.

### What Carries Over

- The copy starts **unarchived** with **no documents generated** yet, even if the original is archived or has been used many times.
- For an **Astalty Template**, the copy gets its own hold on the content's images and on the Front Page, Body, and Header & Footer settings, so deleting the original afterwards doesn't affect the copy.
- For a **Word Template**, the uploaded file is copied too, so the two Templates never share a file - editing or replacing one leaves the other untouched.

## How to Generate a Custom Template

To generate a Custom Template:

- **Participants** - open the Participant profile and select **Templates**. See [Participant Templates](https://docs.astalty.com.au/guide/participants/templates/custom-templates).
- **Users** - open the user profile and select **Templates**. See [User Templates](https://docs.astalty.com.au/guide/users/templates).

Once in these menus you will see the Custom Templates uploaded to your Astalty account where you will be able to Generate and complete the documents.
