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

# Rules

> Use Grunt rules to apply reusable formatting and data-driven behavior

Rules are the core formatting and visualization system in Grunt.

## What rules do

Rules let you define behavior instead of formatting each value manually.

Examples from the legacy support guidance:

* Change the font, border, fill, or size of selected content
* Show icons or graphics based on values
* Turn values into bars, gauges, or other visual elements
* Reuse the same formatting logic across multiple rows, columns, or objects

This is why rules save time when your data changes.

## Add a rule

1. Select the part of the object you want to change.
2. Right-click and choose **Add rule**, or press `Ctrl` + `Enter`.
3. Choose the rule from the dialog.
4. Enable the properties you want to control.

Most properties start in a default state and do nothing until you activate them.

## Understand the rule dialog

The legacy articles split the rule dialog into two main areas:

* **Property section** at the top, where you turn individual settings on or off
* **Target section** at the bottom, where you define where the rule applies

If a rule supports different content types, you can often target:

* The cell itself
* Text inside the object
* Graphics created by rules

## Understand the rule stack

Every rule appears in the rule stack on the edge of the PowerPoint window.

* Rules are applied from the bottom up.
* A rule higher in the stack wins if two rules control the same setting on the same target.
* You can drag rules up or down to change precedence.

If nothing changes after you edit a rule, another rule higher in the stack may be overriding it.

## Rule families

Use these pages to find every legacy rule now migrated into Mintlify:

> **[Text and number rules](https://docs.grunt.io/powerpoint-add-in/user/rules-text-and-number.md)**
>
> Font, paragraph style, number format, fill, border, and text rotation.

> **[Layout and structure rules](https://docs.grunt.io/powerpoint-add-in/user/rules-layout-and-structure.md)**
>
> Alignment, margin, merge, size, and clear.

> **[Visual and logo rules](https://docs.grunt.io/powerpoint-add-in/user/rules-visual-and-logo.md)**
>
> Chevron, header underline, icon, icon conditional, and logo.

> **[Gauges and value source](https://docs.grunt.io/powerpoint-add-in/user/rules-gauges-and-value-source.md)**
>
> Donut gauge, bar gauge, and value-source-driven rule patterns.

## All legacy rules covered

| Legacy rule | Mintlify page |
| - | - |
| Font (character style) rule | [Text and number rules](https://docs.grunt.io/powerpoint-add-in/user/rules-text-and-number.md) |
| Alignment rule | [Layout and structure rules](https://docs.grunt.io/powerpoint-add-in/user/rules-layout-and-structure.md) |
| Chevron rule | [Visual and logo rules](https://docs.grunt.io/powerpoint-add-in/user/rules-visual-and-logo.md) |
| Fill rule | [Text and number rules](https://docs.grunt.io/powerpoint-add-in/user/rules-text-and-number.md) |
| Header, underline rule | [Visual and logo rules](https://docs.grunt.io/powerpoint-add-in/user/rules-visual-and-logo.md) |
| Icon rule | [Visual and logo rules](https://docs.grunt.io/powerpoint-add-in/user/rules-visual-and-logo.md) |
| Icon conditional rule | [Visual and logo rules](https://docs.grunt.io/powerpoint-add-in/user/rules-visual-and-logo.md) |
| Logo rule | [Visual and logo rules](https://docs.grunt.io/powerpoint-add-in/user/rules-visual-and-logo.md) |
| Margin rule | [Layout and structure rules](https://docs.grunt.io/powerpoint-add-in/user/rules-layout-and-structure.md) |
| Merge rule | [Layout and structure rules](https://docs.grunt.io/powerpoint-add-in/user/rules-layout-and-structure.md) |
| Number format rule | [Text and number rules](https://docs.grunt.io/powerpoint-add-in/user/rules-text-and-number.md) |
| Paragraph style rule | [Text and number rules](https://docs.grunt.io/powerpoint-add-in/user/rules-text-and-number.md) |
| Size rule | [Layout and structure rules](https://docs.grunt.io/powerpoint-add-in/user/rules-layout-and-structure.md) |
| Border rule | [Text and number rules](https://docs.grunt.io/powerpoint-add-in/user/rules-text-and-number.md) |
| Value source in Rules | [Gauges and value source](https://docs.grunt.io/powerpoint-add-in/user/rules-gauges-and-value-source.md) |
| Donut (gauge) rule | [Gauges and value source](https://docs.grunt.io/powerpoint-add-in/user/rules-gauges-and-value-source.md) |
| Bar (gauge) rule | [Gauges and value source](https://docs.grunt.io/powerpoint-add-in/user/rules-gauges-and-value-source.md) |
| Text rotation rule | [Text and number rules](https://docs.grunt.io/powerpoint-add-in/user/rules-text-and-number.md) |
| Clear rule | [Layout and structure rules](https://docs.grunt.io/powerpoint-add-in/user/rules-layout-and-structure.md) |

## Target the right areas

Good targeting is what makes rules reusable.

Use these targeting patterns:

* Select the target area before adding the rule when the target is obvious.
* Use include and exclude lists when the target should stay dynamic as the grid changes.
* Use row and column types when the structure matters.
* Use tags when the target spans custom cells or logic-based groups.

Continue to [Visual Grids](https://docs.grunt.io/powerpoint-add-in/user/visual-grids.md) for row types and tags, or to [FAQ and tips](https://docs.grunt.io/powerpoint-add-in/user/faq-and-tips.md) for common targeting edge cases.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.