ansible.builtin.list lookup – simply returns what it is given.


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


  • this is mostly a noop, to be used as a with_list loop when you dont want the content transformed in any way.


- name: unlike with_items you will get 3 items from this loop, the 2nd one being a list
  ansible.builtin.debug: var=item
    - 1
    - [2,3]
    - 4

Return Value



Return value

list / elements=any

basically the same as you fed in

Returned: success


  • Ansible Core Team


Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.