> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-gateway/4/ansible-roles-modules-playbooks/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Ansible roles, modules, and playbooks

> Overview of how Itential Gateway aggregates and allows you to decorate Ansible modules, roles, and playbooks.

Itential Gateway aggregates all of your **Ansible modules, roles, and playbooks**. Along with this, you have the flexibility to decorate or enhance each module, role, and playbook. With decoration, you can edit JSON schemas for identifying and modifying metadata such as input parameters, descriptions, or types. Decoration is currently stored in the database.

> **Info**
>
> Gateway has been updated to address issues related to using the UI to view execution output and execution output history for **Ansible playbooks** when the output exceeds 1MB. In both cases, if Gateway detects the output is greater than 1MB, the raw output will not be displayed in the browser. You will have the option of downloading the output to your system.

#### Log in to Gateway

The main page displays.

#### Click the appropriate group from the left navigation menu

Click **Modules**, **Roles**, or **Playbooks** from the left navigation menu. The navigation tree expands to display a family of configurable items in your Ansible deployment.

#### Expand the family or select a card

Click the accordion arrow to expand the family, or select a card from the main canvas.

#### View item details

From the card view, click the eye icon to display details for the selected item such as required parameters and other inputs.

#### Open the metadata file

Click the **Edit** icon to display the metadata file (JSON schema).

#### Modify the metadata file

Modify the metadata file properties, as needed.

#### Cancel or save your changes

Click **Cancel** ("X") to exit the file without saving changes. Click **Save** to apply your changes.

> Overview of how Itential Gateway aggregates and allows you to decorate Ansible modules, roles, and playbooks.