Navigation
14.16. Assign Layouts to Clients, Contracts, and Defaults
Understand how invoice layouts can be used as tenant defaults or tailored for specific clients, contracts, and contract lines.
After a layout is built and tested, decide where it should apply. Many MSPs use one default layout for most clients and special layouts for clients or contracts that need different invoice presentation.
Assignment levels
Invoice layout assignment can be managed at different scopes depending on how your environment is configured.
| Scope | Use it when | Example |
|---|---|---|
| Tenant default | Most invoices should use the same layout. | Default Managed Services Invoice. |
| Client | One client needs a different invoice format. | GreenLeaf Dental wants service period and backup usage detail. |
| Contract | One agreement needs a special presentation. | Co-Managed Help Desk Retainer uses block-hour detail. |
| Contract line | One billing line needs the most specific layout treatment. | A usage-heavy backup service needs its own detailed presentation. |
The most specific applicable assignment should be used for invoice output. For example, a contract-specific layout takes priority over the tenant default for invoices generated from that contract.
Standard and custom sources
Assignments can use either a standard layout or a custom layout.
| Source | Use it when |
|---|---|
| Standard | You want built-in invoice presentation and do not need custom branding or grouping. |
| Custom | You created a layout for your MSP brand, a client, or a contract. |
Recommended default strategy
For most MSPs:
- Keep a standard layout available as a fallback.
- Create one branded default custom layout for normal monthly billing.
- Create client-specific layouts only when there is a clear billing reason.
- Create contract-specific layouts for unusual agreements, such as co-managed help desk, detailed usage billing, or location-based billing.
- Review assignments after major contract changes.
Assignment checklist
Before assigning a layout:
- preview it with an invoice similar to the one it will render;
- confirm the layout includes the fields required by that client or contract;
- confirm billing staff know why the layout is assigned;
- avoid client-specific wording in a tenant-wide default;
- keep assignment rules simple enough to troubleshoot during billing.
Common examples
| MSP situation | Layout assignment |
|---|---|
| All clients receive the same branded invoice | Set a tenant default custom layout. |
| One healthcare client needs service period detail | Assign a custom layout to that client. |
| A co-managed support contract needs block-hour usage | Assign a custom layout to that contract. |
| A location-based client wants charges separated by site | Assign a layout that groups or labels line items by location. |
When in doubt, use the broad default for normal billing and reserve special assignments for clients that genuinely need them.