> For the complete documentation index, see [llms.txt](https://lewe.gitbook.io/html-and-aui-toolkit-for-confluence/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lewe.gitbook.io/html-and-aui-toolkit-for-confluence/aui-macros/aui-button.md).
# AUI Button
## Description
The AUI provides buttons as well. They are ideal to be used for more prominent links on your page.
The buttons are available in several variations:
| Sample | Button Style | Button Size | Icon | Comment |
| -------------------------------- | ------------ | ----------- | ---- | ----------------------------------------------------------- |
|  | Normal | Normal | | |
|  | Normal | Compact | | |
|  | Primary | Normal | | |
|  | Primary | Compact | | |
|  | Subtle | Normal | | In Confluence, the button shape shows on mouse-over. |
|  | Subtle | Compact | | In Confluence, the button shape shows on mouse-over. |
|  | Primary | Normal | like | Any of the above can be combined with one of the AUI icons. |
## Adding the Macro
1. Edit your page.
2. Select “+” => Other macros
3. Type in “aui” in the Search box
4. Select the “AUI Button” macro
## Macro Options
### **Title**
Enter the title of the button here.
### **Button Style**
Select the style of the button.
### **Button Size**
Select the size of the button here.
### **Button Link**
Enter the full URL here that the button shall link to.
### **Link Relation**
Select the link relation here or leave empty if not sure.
### **Link Target**
Select the link target here or leave empty if not sure.
### **Button Icon**
Check this switch if you want to use an icon in the button.
### **Icon**
Select the icon. This only has an effect if “Button Icon” is checked.
---
# 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, and the optional `goal` query parameter:
```
GET https://lewe.gitbook.io/html-and-aui-toolkit-for-confluence/aui-macros/aui-button.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.