> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitaji360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Opening templates

> If you hire the same kinds of roles again and again — say a "Sales Executive" or a "Software Engineer" — an opening template saves you re-typing the same…

If you hire the same kinds of roles again and again — say a "Sales Executive" or a "Software Engineer" — an opening template saves you re-typing the same job description, salary range, and employment type every time. A template is a reusable starting point that captures the standard details of a role so that creating the next [job opening](/hr/user/recruitment/job-openings) for that role is quicker and more consistent.

This page covers creating, editing, and managing opening templates.

**You'll find this at:** `/hr/recruitment/opening-templates` (list), `/hr/recruitment/opening-templates/new` (create), `/hr/recruitment/opening-templates/:id` (edit)

> 📷 *Screenshot: Opening Templates grid with the "New Template" button — to be added.*

***

## Before you start

* Templates are master data and are managed with the `hr-recruitment:config` permission (the same level used for the other recruitment masters).
* A template can be scoped to the **current business** or, if created without a business in context, shared across the whole tenant. In normal use, with a business selected in the switcher, your templates belong to that business.

***

## Creating a template

From the templates list choose **New Template**. The editor opens with a live preview down the right showing how the role will look.

> 📷 *Screenshot: Template editor — Basic Information, Compensation, Job Description, and the live preview — to be added.*

### Basic information

| Field               | Required | Notes                                                                            |
| ------------------- | -------- | -------------------------------------------------------------------------------- |
| **Template Title**  | Yes      | A name for the template, e.g. "Senior Software Engineer" (up to 255 characters). |
| **Designation**     | No       | The job title / designation this template represents.                            |
| **Employment Type** | No       | Full-time, Part-time, Contract, or Intern.                                       |
| **Location**        | No       | e.g. "Kampala, Uganda".                                                          |

### Compensation

| Field                                       | Required | Notes                                                          |
| ------------------------------------------- | -------- | -------------------------------------------------------------- |
| **Currency**                                | No       | ISO currency code; defaults to UGX.                            |
| **Lower Range** / **Upper Range**           | No       | The salary band.                                               |
| **Per**                                     | No       | The salary period — Month (default), Year, Hour, Week, or Day. |
| **Publish salary range on the job posting** | No       | A toggle carried onto openings created from this template.     |

### Job description

A free-text description for responsibilities, qualifications, and benefits.

Save with **Create Template**.

***

## Editing and deleting

Open a template to edit it; the editor's save button reads **Save Changes**. A **Delete** button (also gated by `hr-recruitment:config`) removes it.

Deleting a template is safe with respect to history: **openings already created from a template are unaffected** — they keep all their own field values. The delete confirmation says as much: *"Delete this opening template? Job openings already created from it are unaffected."*

***

## Using a template

A template is a reference for the standard shape of a role: title, employment type, location, currency, salary band, per-period, and description.

> ⚠️ **Current state:** The "create an opening from this template" one-click prefill is **not wired into the create-opening form** yet. The capability exists behind the scenes, but in the app today the [New Opening form](/hr/user/recruitment/job-openings) does not pull values from a template automatically. In practice, treat templates as a curated reference library — open the template to see the agreed wording and figures, then enter them on the new opening. (Flagged for the team.)

***

## Permissions

| Action                         | Permission              |
| ------------------------------ | ----------------------- |
| View templates                 | `hr-recruitment:read`   |
| Create, edit, delete templates | `hr-recruitment:config` |

***

## Related

* [Job openings](/hr/user/recruitment/job-openings) — the openings templates are meant to speed up
* [Offer term templates](/hr/user/recruitment/offer-term-templates) — the equivalent reusable library for offer terms
* [Recruitment overview & dashboard](/hr/user/recruitment/overview)