---
title: "Use ADD Modifier to Add Dimensions in Pigment Blocks"
slug: "add-modifier"
description: "Learn to use the ADD modifier in Pigment to add one or more Dimensions to a Block and allocate data flexibly."
tags: ["ADD", "Allocation Methods", "Block Dimensions", "Block Management", "Data Distribution", "Excel Add-in", "Modifiers", "Pigment Blocks", "Pigment Functions"]
updated: 2025-05-30T09:37:00Z
published: 2025-08-22T12:00:18Z
---
> ## Documentation Index
> Fetch the complete documentation index at: https://kb.pigment.com/llms.txt
> Use this file to discover all available pages before exploring further.
# ADD modifier
## Description
Adds one or multiple Dimensions to a Block.
It will then distribute the data across those dimensions depending on the defined allocation method.
## Syntax
Adding one dimension
`input_block[ADD: dimension]`
Adding one dimension with allocation method
`input_block[ADD Allocation method: dimension]`
Adding more than one dimension and allocation method
`input_block[ADD Allocation method: dimension1, dimension2, ...]`
## Return type
`same as source object`
## Allocation Methods
**Constant**- this method will take the value from the source metric or property and apply it to every item within the newly added dimensions. This is the default behavior if no allocation method is defined.
`input_block[ADD Constant: dimension]`
**Split**- this method will take the value from the source metric or property and distribute it evenly across the items within the newly added dimensions.
`input_block[ADD split: dimension]`
### Example
Source Metric Country is a simple metric with one dimension, Country. In this example, the Month dimension is added first, then you can see a custom allocation method of SPLIT is defined.
**Excel equivalent**: none
**See also**: [REMOVE](/v1/docs/remove-modifier)
> [!NOTE]
> For detailed insights and video discussions on typical use cases and common pitfalls of the ADD modifier by a Pigment Solution Architect, explore the [ADD & REMOVE Modifier](https://academy.gopigment.com/add-remove-modifiers) module in the Academy.