> For the complete documentation index, see [llms.txt](https://help.marcopayroll.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.marcopayroll.com/marco-user-guide-x4/2025/marco-platform-structure/customer-portal/manager-guide/payroll/managing-salary-packages.md).
# Managing Salary Packages
Who can use this feature:
* Admin Managers
* Payroll Managers
In Marco, a staff member's **salary package** is recorded as **individual pay items**, such as **Basic Salary, Transport Allowance, and Sales Commission**. Each pay item is configured based on:
* **Country**
* **Item Type**
* **Frequency**
Each pay item can contain multiple **entries**, with details such as:
* **Pay Amount**
* **Currency**
* **Payment Type** (Gross, Net, or Cost to Company)
* **Effective Date**
* **End Date (if applicable)**
***
### **Assigning Salary Packages to Staff**
When adding a salary package in Marco for the first time, begin by adding the necessary pay items. You can later add **new entries** to reflect any adjustments to the salary package.
When a **salary adjustment** is made, the **new entry overrides the previous entry** from the new **effective date** onwards. For details on managing adjustments, refer to **Salary Adjustments**.
Only **active pay item entries** appear on the staff's **Pay Details** page. Overridden entries and future-dated entries will not be displayed.
***
### **Salary Adjustments**
Salary packages can change due to various factors. Adjustments can be managed by following these steps:
#### **Examples**
* **New Pay Item Added**
* Due to a **policy change**, all staff will receive a **transport allowance** starting **September 2021**.
* A **new pay item** (Transport Allowance) is added with an **effective date of 1 September 2021**.
* On **1 September 2021**, affected staff will see **Transport Allowance** in their **Pay Details**.
* **Pay Increase**
* Staff X receives an **annual salary increment** at the end of **2023**.
* A **new entry** is added to **Basic Salary**, with the updated amount and an **effective date of 1 January 2024**.
* The **previous entry** is updated with an **end date of 31 December 2023**.
* On **1 January 2024**, Staff X will see the **updated salary details** in their **Pay Details**.
* **Pay Item Removed**
* Due to **budget cuts**, the **Food Allowance** is discontinued **after July 2020**.
* The **existing Food Allowance entry** is updated with an **end date of 31 July 2020**.
* From **1 August 2020** onwards, affected staff will **no longer see** the **Food Allowance** in their **Pay Details**.
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.marcopayroll.com/marco-user-guide-x4/2025/marco-platform-structure/customer-portal/manager-guide/payroll/managing-salary-packages.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.