---
title: Macro expressions
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

Macros are text expressions that the system evaluates and converts into values. By using macros, you can create dynamic website content and in general configure the application to perform different actions under different conditions. Macros range from simple expressions for loading values from data in the system, to complex sets of instructions that lead to a certain result.

> **Info:** 
>
> ### [Learn the macro syntax](https://docs.kentico.com/k12sp/macro-expressions/macro-syntax.md)
>
> Kentico uses a macro language (K#) with a wide range of syntax options and features.

> **Info:** 
>
> ### [Enter macro expressions in the system](https://docs.kentico.com/k12sp/macro-expressions/entering-macro-expressions.md)
>
> Learn where in the Kentico user interface you can enter macro expressions, and about the available assistance features.

> **Info:** 
>
> ### [Write macro conditions](https://docs.kentico.com/k12sp/macro-expressions/writing-macro-conditions.md)
>
> One of the most common ways to leverage macros is to define dynamic conditions for various types of functionality.
>
> - [Build conditions using a text-based interface (macro rules)](https://docs.kentico.com/k12sp/macro-expressions/writing-macro-conditions/building-conditions-using-macro-rules.md)
> - [Create custom macro rules](https://docs.kentico.com/k12sp/macro-expressions/writing-macro-conditions/creating-macro-rules.md)

> **Info:** 
>
> ### [Find information about macro methods](https://docs.kentico.com/k12sp/macro-expressions/reference-macro-methods.md)
>
> The system provides a large number of methods that you can call in macro expressions. View this reference to learn about the available methods.

> **Info:** 
>
> ### [Troubleshoot macros](https://docs.kentico.com/k12sp/macro-expressions/troubleshooting-macros.md)
>
> If you encounter problems when working with macro expressions, the system provides several tools that can help identify and fix the issues:
>
> - [Search the system for macro expressions](https://docs.kentico.com/k12sp/macro-expressions/troubleshooting-macros/searching-for-macros.md)
> - [Debug macros](https://docs.kentico.com/k12sp/macro-expressions/troubleshooting-macros/debugging-macros.md)
> - [Solve problems with macro signatures](https://docs.kentico.com/k12sp/macro-expressions/troubleshooting-macros/working-with-macro-signatures.md)

> **Info:** 
>
> ### [Extend the macro engine](https://docs.kentico.com/k12sp/macro-expressions/extending-the-macro-engine.md)
>
> If the default functionality of the macro engine does not cover all of your requirements, developers can extend the macro engine.
>
> Learn to create custom:
>
> - [Macro methods](https://docs.kentico.com/k12sp/macro-expressions/extending-the-macro-engine/registering-custom-macro-methods.md)
> - [Macro fields (properties)](https://docs.kentico.com/k12sp/macro-expressions/extending-the-macro-engine/adding-custom-macro-fields.md)
> - [Macro namespaces](https://docs.kentico.com/k12sp/macro-expressions/extending-the-macro-engine/creating-macro-namespaces.md)

## Macro expressions on MVC sites

When working with the [MVC development model](https://docs.kentico.com/k12sp/developing-websites/mvc-development-overview.md), usage of macros is fully supported for the administration interface and for all processes that run within the Kentico application (for example [marketing automation](https://docs.kentico.com/k12sp/on-line-marketing-features/managing-your-on-line-marketing-features/marketing-automation.md) processes or recalculation of [contact scores](https://docs.kentico.com/k12sp/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management/scoring-contacts.md)).

However, macros are not automatically resolved when [displaying page content](https://docs.kentico.com/k12sp/developing-websites/retrieving-content-in-mvc-applications/displaying-page-content.md) on your MVC site. If you wish to use macros within page content, you need to manually resolve the [macros using the API](https://docs.kentico.com/k12sp/macro-expressions/resolving-macros-using-the-api.md) before you render the data on the live site.