ansible.builtin.varnames – Lookup matching variable names


This module is part of ansible-core and included in all Ansible installations. In most cases, you can use the short module name varnames even without specifying the collections: keyword. However, we recommend you use the FQCN for easy linking to the module documentation and to avoid conflicting with other collections that may have the same module name.

New in version 2.8: of ansible.builtin


  • Retrieves a list of matching Ansible variable names.


Parameter Choices/Defaults Configuration Comments
string / required
List of Python regex patterns to search for in variable names.


- name: List variables that start with qz_
  debug: msg="{{ lookup('varnames', '^qz_.+')}}"
    qz_1: hello
    qz_2: world
    qa_1: "I won't show"
    qz_: "I won't show either"

- name: Show all variables
  debug: msg="{{ lookup('varnames', '.+')}}"

- name: Show variables with 'hosts' in their names
  debug: msg="{{ lookup('varnames', 'hosts')}}"

- name: Find several related variables that end specific way
  debug: msg="{{ lookup('varnames', '.+_zone$', '.+_location$') }}"

Return Values

Common return values are documented here, the following are the fields unique to this lookup:

Key Returned Description
list / elements=string
List of the variable names requested.


  • Ansible Core Team