> For the complete documentation index, see [llms.txt](https://docs.dogq.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dogq.io/documentation/macros.md).
# Macros
### What is Macro
Macros are pre-defined sets of test steps that can be shared across multiple Scenarios. In other words they are reusable chunks of tests that you can plug into as many Scenarios as you need. A typical example is creating a "precondition" step, e.g., logging in with a specific user before executing the rest of the steps, i.e. the actual test.
Changes made to a Macro will be reflected in all the Scenarios it is used in, allowing for great flexibility and speed when creating a large number of tests. Proactively using Macros make your tests more modular and readable, enabling you to make adjustments to your Scenarios on the fly by simply moving blocks around.
### Creating a new Macro
There is a dedicated **Macros** [page](https://dogq.io/macros) you can access from the sidebar. It contains a list of all the Macros you and any Team member have created, making it a Macros management tool.
Here you can create a new Macro by clicking on the button and specifying a Name.
{% hint style="info" %}
Optionally, you can **bind** the new Macro to a Project, which means that you will only be able to use it inside that Project. This will allow you to use filters when managing your Macros, once you have a large number of them.
{% endhint %}
Inside the new Macro you can add and configure the Scenario steps, just like you would in the Test Editor.
After that, you can add this set of steps to any Scenario with the **Use Macro** step.
### New Macro from Scenario
You can also use the Actions dropdown menu right in the Test Editor. Select the **Create Macro** action to copy the steps from your Scenario into a new Macro.
---
# 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:
```
GET https://docs.dogq.io/documentation/macros.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.