> For the complete documentation index, see [llms.txt](https://docs.phocassoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.phocassoftware.com/budgets-and-forecasts/workforce-planning/create-a-workforce-plan.md).

# Create a workforce plan

Create a workforce plan using a template or your own setup, duplicate an existing plan, and update the plan setup as your needs change.

{% hint style="info" icon="key" %}
Permission: **Manage Budgets & Forecasts**
{% endhint %}

There are several ways to create a workforce plan:

* [Use a template](#start-from-a-template): The quickest way to create a plan. The column structure is already set up, so you only need to add a plan name and administrators. You can customize the setup later.
* [Customize your own plan](#customize-your-own-plan): Build a plan from scratch when you want to choose your own column structure, benefits, and benefit plans.
* Import from a file: This feature is coming soon.
* [Duplicate an existing plan](#duplicate-a-workforce-plan): After you create a plan, duplicate it to quickly create a similar plan. You can reuse the plan configuration and, optionally, its employee information. For example, you might create separate plans for different scenarios or for a budget and forecast.

<figure><img src="https://2974338405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaNH5UMuZXBHuAbFF7nI2%2Fuploads%2FwcwWwDxRjsQgk7kk3SsA%2Fimage.png?alt=media&amp;token=34a34e66-0a5e-44bf-b381-84c7c50a4d20" alt=""><figcaption></figcaption></figure>

The plan structure defines what information you capture for each employee and how it's organized. Regardless of how you create the plan, each plan contains one or more groups of columns, with employee data in the rows.

## Start from a template

1. On the [**Workforce Planning** page](https://docs.phocassoftware.com/budgets-and-forecasts/workforce-planning/take-a-tour-of-workforce-planning.md), click **Create plan**.
2. Click **Use template**.
3. Select a template:
   * **Basic**: Includes a predefined column structure for workforce planning.

     <div align="left"><figure><img src="https://2974338405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaNH5UMuZXBHuAbFF7nI2%2Fuploads%2FImPmnvJDrfYjGIRqOgLn%2Fimage.png?alt=media&amp;token=5fe83208-7903-4ee4-89ef-424201e12afe" alt=""><figcaption><p>Column structure in the Basic template</p></figcaption></figure></div>
   * **Benefits-ready**: Includes the same column structure as the Basic template, plus predefined benefits and benefit plans.

     <div align="left"><figure><img src="https://2974338405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaNH5UMuZXBHuAbFF7nI2%2Fuploads%2FF5WNAmxFmQtw22yQue3G%2Fimage.png?alt=media&amp;token=7d75bfed-faed-4ade-9ecb-3256901bf43b" alt=""><figcaption><p>Column structure in the Benefits-ready template</p></figcaption></figure></div>
4. Click **Next**.
5. Enter a name for the plan.
6. Select the [plan administrators](#learn-about-plan-administrators).
7. Click **Save and finish**. The new workforce plan opens and is ready for you to [add employees](https://docs.phocassoftware.com/budgets-and-forecasts/workforce-planning/create-a-workforce-plan/add-employees.md).
8. If you selected the **Benefits-ready** template, review the predefined benefits and benefit plans and update them as required:
   1. Click the menu button on the **Benefit plan** column header, then click **Edit**.
   2. Edit or remove the existing benefits, or add new ones as required, then click **Next**.<br>

      <figure><img src="https://2974338405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaNH5UMuZXBHuAbFF7nI2%2Fuploads%2FQKnXnqQteWyY9zXx6ynl%2Fimage.png?alt=media&amp;token=c10eaedc-3f88-4a27-967d-6920f8452de6" alt=""><figcaption></figcaption></figure>
   3. Edit or remove the existing benefit plans, or add new ones as required, then click **Save and finish**.<br>

      <figure><img src="https://2974338405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaNH5UMuZXBHuAbFF7nI2%2Fuploads%2FfuyQFlfOVvkfe0TBqNXS%2Fimage.png?alt=media&amp;token=c6638262-9579-43ce-99ec-2076a798a6e5" alt=""><figcaption></figcaption></figure>

## Customize your own plan

Build a workforce plan from scratch when you want to define your own column structure, remuneration, benefits, and benefit plans.

1. On the [**Workforce Planning** page](https://docs.phocassoftware.com/budgets-and-forecasts/workforce-planning/take-a-tour-of-workforce-planning.md), click **Create plan**.
2. Click **Start from scratch**. The **Plan setup** panel opens.
3. On the **Plan configuration** step:
   1. Enter a name for the plan.
   2. Select the [plan administrators](#learn-about-plan-administrators).
   3. Click **Next** to continue to the **Columns** step.

<div align="left"><figure><img src="https://2974338405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaNH5UMuZXBHuAbFF7nI2%2Fuploads%2FkCJcx6t5FgZWJ5fYbkKp%2Fimage.png?alt=media&amp;token=9d11a7e4-e1aa-4c8b-ae59-e94db4999d2e" alt="" width="563"><figcaption></figcaption></figure></div>

### Set up columns and groups

On the **Columns** step, you organize columns into groups, defining all of your column groups and the columns within each, on the one screen. Each group displays as its own expandable section, which you can collapse using the chevron beside its name to focus on other groups.

The **Remuneration** group is included by default. It contains the remuneration measures you set up within it. You can't remove this group — its delete (**✕**) button is disabled — but you can rename it using the pencil icon beside its name.

{% hint style="info" %}
Benefits are calculated from measures in the **Remuneration** column group, so you can't rename or remove these measures. If you need another remuneration-style measure that shouldn't affect benefit calculations, add it to another column group.
{% endhint %}

<figure><img src="https://2974338405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaNH5UMuZXBHuAbFF7nI2%2Fuploads%2F7xZ2VpapN36nPfhlBb4r%2Fimage.png?alt=media&amp;token=41bf9ba6-6efe-4833-ba50-5976b98538af" alt=""><figcaption></figcaption></figure>

Add other groups and columns as required. For example, you might create groups for:

* Employee attributes, with columns such as gender, age range, or manager.
* Organizational categories, with columns such as business unit or department.

1. (Optional) Click **Add group** at the top of the step and enter a name for the group. Repeat this step to add more groups as required.
2. Within a group, click **Add column** and select the column type:\
   \
   ![](https://2974338405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaNH5UMuZXBHuAbFF7nI2%2Fuploads%2FFEAcZQGLCI5RVqmqTzcq%2Fimage.png?alt=media\&token=f63cddcb-dbbb-438f-857f-d194f848dfa8)

<table><thead><tr><th width="133" valign="top">Column type</th><th width="323" valign="top">Purpose and setup</th><th valign="top">When entering employee information</th></tr></thead><tbody><tr><td valign="top"><strong>Database dimension</strong></td><td valign="top"><p>Use a dimension that already exists in a Phocas database.</p><p>Use this option when you need to map workforce plan data to financial data in Budgets &#x26; Forecasts.</p><p>Select the database and dimension, then rename the dimension if you want it to display differently in the workforce plan.</p></td><td valign="top">Select an entity from the dimension in the underlying database.</td></tr><tr><td valign="top"><strong>Custom dimension</strong></td><td valign="top"><p>Create a new dimension that doesn't already exist in Phocas.</p><p>For example, you might create one for gender, age range, or manager.</p></td><td valign="top"><p>Enter an entity name.</p><p>New entities are added to the dimension as you work.</p></td></tr><tr><td valign="top"><strong>Database measure</strong></td><td valign="top"><p>Use an existing measure from the Workforce database.</p><p>Database measures are static by default; change the setting to <strong>Effective dated</strong> if the value needs to change over time.</p></td><td valign="top"><p>Enter a numeric value.</p><p>For a static measure, the value applies for the employee's employment period.</p><p>For an effective-dated measure, you can change the value over time.</p></td></tr><tr><td valign="top"><strong>Custom measure</strong></td><td valign="top"><p>Create a new measure.</p><p>Custom measures are static by default; change the setting to <strong>Effective dated</strong> if the value needs to change over time. Measures that contain formulas should be static if they're not expected to change.</p></td><td valign="top"><p>Enter a numeric value.</p><p>For a static measure, the value applies for the employee's employment period.</p><p>For an effective-dated measure, you can change the value over time.</p></td></tr><tr><td valign="top"><strong>Calculation</strong></td><td valign="top"><p>Build a value from a formula that references other columns in the plan, including columns in other groups.</p><p>Calculations are always static; this can't be changed to effective dated.</p></td><td valign="top">The value is calculated automatically from the referenced columns; you don't enter it directly for each employee.</td></tr><tr><td valign="top"><strong>Property</strong></td><td valign="top"><p>Add a value that isn't projected across time in the same way as an effective-dated measure.</p><p>The value is applied to each day and can be aggregated in the published data using options such as average, period end, period start, or count.</p><p>For example, you might add properties for hourly rates or hours worked.</p></td><td valign="top">Enter the property value.</td></tr></tbody></table>

{% hint style="success" %}
To build a calculation's formula, click the numbered badge in the **#** column beside the column you want to reference, then add an operator (such as **+**) and repeat for each column the formula needs. You can reference columns from any group on the **Columns** step, not only the group you're currently working in.
{% endhint %}

#### Column settings: Spread, Static, and Publish

Depending on the column type, you can configure up to three additional settings:

* **Spread**: How an annualized measure value is distributed when the plan is published — **Daily**, **Monthly**, or **Yearly**. See [Annualized values and spreading](https://docs.phocassoftware.com/budgets-and-forecasts/workforce-planning/overview-of-workforce-planning/workforce-planning-foundations.md#annualized-values-and-spreading). Only applicable to measures (database, custom, and calculation); not applicable to dimensions or properties.
* **Static**: Whether the column's value is fixed for the employee's whole record (**Static**) or can change over time with its own effective date (**Effective dated**). Database measures and custom measures are **Static** by default and can be switched to **Effective dated**. Dimension columns (database and custom) are always **Effective dated** and can't be changed. Calculation columns are always **Static** and can't be changed.
* **Publish**: Currently only available on **Calculation** columns (this may extend to other column types in future). Lets you choose which measure the calculated value publishes to when you publish the plan. **Use column name** publishes the value as its own new measure, named to match the column.

A setting that isn't relevant to a column's type, or can't be changed for that column, shows as **Not applicable** or is disabled.

{% hint style="info" %}
When you create a plan to use alongside an existing plan, such as separate salaried-staff and waged-staff plans, reuse an existing database dimension or measure where it represents the same thing. This keeps published plans consistent and easier to compare. If you duplicate a plan, this reuse happens automatically. See [Employee unique ID](https://docs.phocassoftware.com/budgets-and-forecasts/workforce-planning/overview-of-workforce-planning/workforce-planning-foundations.md#employee-unique-id) for why this matters.
{% endhint %}

3. Give each column a name and configure its settings.
4. Repeat steps 1–3 to add more groups and columns as required. Click the delete (**✕**) icon on a group's header to remove that group (and its columns) entirely. This isn't available for the **Remuneration** group.
5. Click **Next** to continue to the **Benefits** step.

### Add benefits

Benefits represent additional employee costs, such as superannuation, allowances, or payroll-related expenses.

1. Click **Add benefit**.
2. Enter a name for the benefit.
3. (Optional) Enter a description.
4. Select the calculation method:
   * **% Remuneration**: Enter the percentage in the **Calculation** box. Optionally, enter the **Floor** and **Cap** values.
   * **Fixed amount (p/a)**: Enter the annual amount in the **Calculation** box, then select whether to prorate the benefit based on FTE. For example, a 0.5 FTE employee receives 50% of the benefit amount.
5. Repeat these steps to add more benefits as required.
6. Click **Next** to continue to the **Benefit plans** step.

<figure><img src="https://2974338405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaNH5UMuZXBHuAbFF7nI2%2Fuploads%2FnIdkGkotxeooMrUMVNIH%2Fimage.png?alt=media&amp;token=675e30b8-90ca-4230-b73f-cdbfb5f89f83" alt=""><figcaption></figcaption></figure>

### Add benefit plans

Benefit plans allow you to group related benefits together. For example, you might create separate benefit plans for employees in different countries or employment types.

1. Click **Add benefit plan**.
2. Enter a name for the benefit plan.
3. Click **Select at least one benefit**, select the benefits to include, then click **Save**.
4. Repeat these steps to add more benefit plans as required.
5. Click **Save and finish**.

<figure><img src="https://2974338405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaNH5UMuZXBHuAbFF7nI2%2Fuploads%2FG1UIBVQlyaQdSfWsOO0n%2Fimage.png?alt=media&amp;token=62e36361-3946-4e5f-b07e-00a31b8395f9" alt=""><figcaption></figcaption></figure>

The new workforce plan opens and is ready for you to [add employees](https://docs.phocassoftware.com/budgets-and-forecasts/workforce-planning/create-a-workforce-plan/add-employees.md).

## Duplicate a workforce plan

Duplicating creates a copy of an existing workforce plan. The entire setup is copied, including administrators, benefits, benefit plans, column groups, columns, and dimension mappings. You can choose whether to include the employee rows or start with an empty plan.

Duplicating is useful when you want to keep the detail of an existing plan intact while working on a variant. For example, roll a Budget plan into a separate Forecast plan by duplicating it rather than editing and republishing the original.

When you publish the duplicated plan, it writes to its own stream in the Workforce database, named to match the plan.

1. On the [Workforce Planning homepage](https://docs.phocassoftware.com/budgets-and-forecasts/workforce-planning/take-a-tour-of-workforce-planning.md), click the plan's menu button and click **Duplicate**.

   <figure><img src="https://2974338405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaNH5UMuZXBHuAbFF7nI2%2Fuploads%2Fgit-blob-5d0c39fae2a5d873a9ab7b738492d9905b6ae782%2Fimage%20(614).png?alt=media" alt=""><figcaption></figcaption></figure>
2. Enter a name for the new plan. The name must be different from any existing plan.
3. (Optional) Clear the **Include current data** checkbox if you don't want to copy the employee rows into the new plan. Only the plan's setup will be copied.
4. Click **Duplicate**. The new plan opens.

## Learn about plan administrators

By default, you are the only administrator of the workforce plan and the only person who can access it.

Add other administrators to:

* Ensure someone else in your organization has full access to the plan.
* Help manage and keep the plan up-to-date. Administrators can also publish it.

All plan administrators have the same access. There is no plan owner.

See [Access to the workforce plan and its data](https://docs.phocassoftware.com/budgets-and-forecasts/workforce-planning/overview-of-workforce-planning/workforce-planning-foundations.md#access-to-the-workforce-plan-and-its-data).

## Edit a workforce plan's setup

You can edit a workforce plan setup at any time. For example, you might add or remove plan administrators, create a new benefit, rename a column, or add a new workforce category.

1. [Open the workforce plan](https://docs.phocassoftware.com/budgets-and-forecasts/workforce-planning/take-a-tour-of-workforce-planning.md#explore-the-plan).
2. Choose how you want to edit the setup:
   * **Edit the entire setup**: Click **Plan** > **Edit plan setup**.

     This is the only way to edit the plan name and administrators. You can also review or update all setup sections.

     <div align="left"><figure><img src="https://2974338405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaNH5UMuZXBHuAbFF7nI2%2Fuploads%2Fgit-blob-cc33d62f7853fcefec163d7cee7ec2bb6ebeb476%2Fimage%20(616).png?alt=media" alt="" width="196"><figcaption></figcaption></figure></div>
   * **Edit a specific section**: On the required column group header or **Benefit plan** column header, click the menu button, then click **Edit**.\
     This opens only that section of the setup, allowing you to make a quick change.

     <div align="left"><figure><img src="https://2974338405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaNH5UMuZXBHuAbFF7nI2%2Fuploads%2Fgit-blob-1d44b58643271797864c86b59858d2bc047ab35e%2Fimage%20(617).png?alt=media" alt="" width="358"><figcaption></figcaption></figure></div>
3. Update the settings as required. See [Customize your own plan](#customize-your-own-plan) for information about each setting.
4. Click **Save and finish**.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.phocassoftware.com/budgets-and-forecasts/workforce-planning/create-a-workforce-plan.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
