Templates

Templates

Create Confluence pages from reusable templates with variable substitution and Handlebars syntax.

Prerequisites

• Authenticated profile (atlcli auth login)
• Space permission: Edit permission to create pages from templates

Overview

The template system provides:

• Hierarchical storage: Global, profile, and space-level templates
• Precedence: Space > Profile > Global (most specific wins)
• Handlebars syntax: Full logic support (if, unless, each, with)
• Built-in variables: Date, time, user, space, and more
• Import/export: Share template packs via directories, Git, or URLs

Quick Start

# Create a template
atlcli wiki template create meeting-notes --file ./meeting.md

# List available templates
atlcli wiki template list

# Create a page from template
atlcli wiki page create --template meeting-notes \
  --var title="Sprint Planning" \
  --var date=2025-01-14 \
  --space TEAM

# Render template to stdout (preview)
atlcli wiki template render meeting-notes --var title="Test"

Template File Format

Templates are Markdown files with YAML frontmatter:

---
name: meeting-notes
description: Template for team meetings
author: Your Name
version: 1.0.0
tags:
  - meeting
  - team
variables:
  - name: title
    type: string
    required: true
    description: Meeting title
  - name: date
    type: date
    required: true
  - name: attendees
    type: string
    default: "TBD"
  - name: type
    type: select
    options:
      - standup
      - planning
      - retro
    required: true
---
# {{title}}

**Date:** {{@date}}
**Type:** {{type}}
**Attendees:** {{attendees}}

## Agenda

{{#if agenda}}
{{agenda}}
{{else}}
- Item 1
- Item 2
{{/if}}

## Notes

<!-- Add meeting notes here -->

## Action Items

| Owner | Action | Due |
|-------|--------|-----|
|       |        |     |

Variable Types

Type	Description	Validation
string	Free text	None
number	Numeric value	Must be valid number
date	Date value	ISO 8601 or relative (today, tomorrow)
boolean	True/false	Accepts true/false, yes/no, 1/0
select	Enum from options	Must match one of options

Built-in Variables

Built-in variables use the @ prefix:

Variable	Description	Example
{{@date}}	Current date	2025-01-14
{{@datetime}}	Date and time	2025-01-14T10:30:00
{{@time}}	Current time	10:30
{{@year}}	Current year	2025
{{@month}}	Current month	01
{{@day}}	Current day	14
{{@weekday}}	Day of week	Tuesday
{{@user}}	Current user	john.doe
{{@space}}	Space key	TEAM
{{@profile}}	Profile name	work
{{@title}}	Page title	From context
{{@parent.id}}	Parent page ID	12345
{{@parent.title}}	Parent page title	Parent Page
{{@uuid}}	Random UUID	550e8400-e29b-…

Storage Locations

atlcli stores templates at three levels with precedence (space > profile > global):

Global Templates

~/.atlcli/templates/global/
├── meeting-notes.md
└── decision-record.md

Profile Templates

~/.atlcli/templates/profiles/
└── work/
    └── standup.md

Space Templates

# In synced docs folder (checked first)
./my-docs/.atlcli/templates/
└── runbook.md

# Or under config
~/.atlcli/templates/spaces/TEAM/
└── team-specific.md

Selecting a Level

The same template name can exist at several levels. show, create, edit, delete, rename, validate <name>, render, list, and export all select the level the same way:

Flag	Effect
--level global|profile|space	Use that level exactly
--profile <name>	Use the profile level, for that profile (implies --level profile)
--space <key>	Use the space level, for that space (implies --level space)
(none)	Reads resolve by precedence (space > profile > global); create targets the current space, else global

Three rules keep a named level from turning into a different one:

• A named level is never a fallback. --level profile reads, writes, and deletes at the profile level only. If the template is not there, the command fails with Template 'x' not found at profile:work. — it does not quietly use the space or global copy.
• Contradictory flags fail. --level global --profile work, --level space --profile work, and --profile work --space TEAM each name two levels, so the command exits 1 instead of picking one.
• Config defaults supply coordinates, not levels. An active profile and a default space fill in the which profile / which space for a level you named. They never select the level themselves. Naming a level with no context available — --level profile with no active profile, --level space with no default space — is a usage error.

# Delete the profile copy; the space and global copies are untouched
atlcli wiki template delete standup --level profile --force

# Read the global copy even though a space copy shadows it
atlcli wiki template show meeting-notes --level global

# Rejected: two different levels named
atlcli wiki template show meeting-notes --level global --profile work
# → --level global conflicts with --profile work.

Caution

Behaviour change. Earlier releases accepted --level profile and --level space but ignored them: only --level global was honoured, and the other two fell back to precedence resolution. atlcli wiki template delete <name> --level profile --force could therefore delete the space-level template and report success. If you have scripts that relied on that fallback, they now fail loudly instead of acting on the wrong file.

Commands

List Templates

# List all templates
atlcli wiki template list

# Filter by level
atlcli wiki template list --level global
atlcli wiki template list --profile work
atlcli wiki template list --space TEAM

# Filter by tag
atlcli wiki template list --tag meeting

# Search
atlcli wiki template list --search retro

# Include overridden templates
atlcli wiki template list --all

# JSON output
atlcli wiki template list --json

Show Template

# Show template details and content (precedence: space > profile > global)
atlcli wiki template show meeting-notes

# Show from a specific level
atlcli wiki template show standup --profile work
atlcli wiki template show meeting-notes --level global
atlcli wiki template show runbook --level space

See Selecting a Level for how --level, --profile, and --space interact.

Create Template

# From file
atlcli wiki template create meeting-notes --file ./template.md

# Open in $EDITOR
atlcli wiki template create meeting-notes

# Interactive wizard
atlcli wiki template create --interactive

# Create at a specific level
atlcli wiki template create standup --profile work --file ./standup.md
atlcli wiki template create runbook --space TEAM --file ./runbook.md
atlcli wiki template create shared --level global --file ./shared.md

# Without a level flag, create targets the current space if there is one,
# otherwise global. Name the level when it matters.
atlcli wiki template create standup --level profile --file ./standup.md

# Overwrite existing
atlcli wiki template create meeting-notes --file ./updated.md --force

Edit Template

# Opens in $EDITOR
atlcli wiki template edit meeting-notes

# Edit at a specific level
atlcli wiki template edit standup --profile work
atlcli wiki template edit meeting-notes --level global

edit saves back to the level it read from, so naming the level decides which file you change.

Delete Template

# With confirmation
atlcli wiki template delete meeting-notes

# Force delete
atlcli wiki template delete meeting-notes --force

# Delete from a specific level
atlcli wiki template delete standup --profile work --force
atlcli wiki template delete meeting-notes --level global --force

Without a level flag, delete removes whatever precedence resolves to — the space copy first. The command reports the level it deleted from, e.g. Deleted template 'standup' from [profile:work].

Rename Template

atlcli wiki template rename old-name new-name
atlcli wiki template rename standup daily-standup --profile work
atlcli wiki template rename runbook ops-runbook --level space

Renaming affects one level only; same-named templates at other levels keep their name.

Validate Template

# Validate specific template
atlcli wiki template validate meeting-notes

# Validate a template at a specific level
atlcli wiki template validate standup --level profile

# Validate from file
atlcli wiki template validate --file ./template.md

# Validate all templates
atlcli wiki template validate --all

Exit codes — validate is a CI gate:

Outcome	Exit code
Valid, no warnings	0
Valid, with warnings (e.g. undeclared variable)	0
Invalid (e.g. unclosed {{#if}})	1
Template or file not found	1

The report is written to stdout either way; with --json it stays a single JSON document whose valid field carries the verdict.

# Fail a pipeline on any invalid template
atlcli wiki template validate --all || exit 1

Caution

Behaviour change. validate used to exit 0 even when a template was invalid, which made it useless as a gate. Pipelines that ran it for its output only will now fail on invalid templates.

Render Template

# Render to stdout
atlcli wiki template render meeting-notes --var title="Sprint Planning"

# With multiple variables
atlcli wiki template render meeting-notes \
  --var title="Planning" \
  --var date=today \
  --var type=planning

# Interactive prompts for missing variables
atlcli wiki template render meeting-notes --interactive

# Output to file
atlcli wiki template render meeting-notes --var title="Test" > output.md

# JSON output
atlcli wiki template render meeting-notes --var title="Test" --json

Init Template from Existing Content

# From Confluence page ID
atlcli wiki template init meeting-template --from 12345

# From page title (requires --from-space)
atlcli wiki template init meeting-template --from "Team Meetings" --from-space TEAM

# From local file
atlcli wiki template init meeting-template --from ./docs/meetings.md

# Save to specific level
atlcli wiki template init retro --from 12345 --to-profile work

Copy Template

# Copy between levels
atlcli wiki template copy meeting-notes --from-level global --to-profile work

# Copy with rename
atlcli wiki template copy meeting-notes team-meeting --from-level global --to-space TEAM

Import/Export

Export Templates

# Export all to directory
atlcli wiki template export -o ./my-templates

# Export single template to stdout
atlcli wiki template export meeting-notes

# Export single to file
atlcli wiki template export meeting-notes -o ./meeting-notes.md

# Export from a specific level
atlcli wiki template export --profile work -o ./work-templates

# Export one template from a named level
atlcli wiki template export meeting-notes --level global

Export directory structure:

./my-templates/
├── manifest.yml
├── global/
│   └── meeting-notes.md
├── profiles/
│   └── work/
│       └── standup.md
└── spaces/
    └── TEAM/
        └── runbook.md

Import Templates

# From local directory
atlcli wiki template import ./my-templates

# From Git URL
atlcli wiki template import https://github.com/user/template-pack

# From tar.gz URL
atlcli wiki template import https://example.com/templates.tar.gz

# Flatten to single level
atlcli wiki template import ./templates --to-profile work

# Replace existing (default: skip)
atlcli wiki template import ./templates --replace

# Import specific templates only
atlcli wiki template import ./templates meeting-notes standup

Update from Remote

# Update all tracked templates
atlcli wiki template update

# Update specific templates
atlcli wiki template update meeting-notes standup

# Update from specific source
atlcli wiki template update --source https://github.com/user/template-pack

Using Templates with Page Create

# Create page from template
atlcli wiki page create --template meeting-notes \
  --var title="Sprint Planning" \
  --var date=2025-01-14 \
  --space TEAM

# Interactive prompts for variables
atlcli wiki page create --template meeting-notes --space TEAM

# Dry run (preview)
atlcli wiki page create --template meeting-notes \
  --var title="Test" \
  --dry-run

Handlebars Syntax

Templates support full Handlebars syntax:

Conditionals

{{#if attendees}}
**Attendees:** {{attendees}}
{{else}}
**Attendees:** TBD
{{/if}}

{{#unless draft}}
This is published content.
{{/unless}}

Loops

{{#each items}}
- {{this}}
{{/each}}

{{#each tasks}}
- [ ] {{this.title}} ({{this.assignee}})
{{/each}}

With Context

{{#with author}}
**Author:** {{name}} ({{email}})
{{/with}}

Default Values

{{attendees "TBD"}}

Tips

1. Use built-in variables for dynamic content like dates and user info
2. Define required variables in frontmatter to ensure pages are complete
3. Use tags to organize templates by category
4. Export templates to share with your team or back up
5. Track sources with import to enable easy updates

Troubleshooting

Variable Not Replaced

Symptom: {{variable}} appears literally in output.

Causes:

• Variable name typo
• Variable not passed with --var
• Missing @ prefix for built-in variables

Fix: Check variable names match frontmatter definitions. Use --interactive to see prompts.

Template Not Found

Symptom: Error: Template 'name' not found

Cause: Template doesn’t exist at any storage level.

Fix: List available templates with atlcli wiki template list --all and check the name.

Template Not Found at a Named Level

Symptom: Template 'name' not found at profile:work.

Cause: The template exists, but not at the level you named. atlcli does not fall back to another level — that is what used to delete the wrong file.

Fix: Run atlcli wiki template list --all to see which level holds it, then name that level, drop the level flag to resolve by precedence, or copy it across with atlcli wiki template copy <name> --from-level global --to-profile work.

Level Flags Conflict

Symptom: --level global conflicts with --profile work. or --profile work and --space TEAM name different levels. Pass only one.

Cause: The flags name two different levels, so there is no single target.

Fix: Pass one level. Use --level profile --profile work to name the level and the profile together, or just --profile work.

No Profile or Space Context

Symptom: No profile context for the profile level. Pass --profile <name> or set an active profile.

Cause: You named a level whose coordinate is unknown — no --profile/--space flag, and no active profile or default space in config.

Fix: Pass the coordinate explicitly (--profile work, --space TEAM), or set it in config with atlcli auth switch <name> for the profile, or a default space in ~/.atlcli/config.json (global.space).

Related Topics

• Pages - Create pages from templates with --template flag
• Macros - Use macros within template content
• Configuration - Template storage paths