# with\_first\_found documentation

**URL:** <https://forum.ansible.com/t/with-first-found-documentation/29242>\
**Category:** Ansible Project\
**Created:** [December 11, 2018, 9:36pm UTC](https://forum.ansible.com/t/with-first-found-documentation/29242 "2018-12-11T21:36:55Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![Baraka\_Baraka](https://avatars.discourse-cdn.com/v4/letter/b/bcef8e/32.png) [@Baraka\_Baraka](https://forum.ansible.com/u/Baraka_Baraka)\
**Post date:** [December 11, 2018, 9:36pm UTC](https://forum.ansible.com/t/with-first-found-documentation/29242/1 "2018-12-11T21:36:55Z")

</div>

Hi!

I am looking for a description what “with\_first\_found” does how it works. I googled and searched the ansible documentation and I can figure it out but guessing is not good way I think. So where can I find a detailed description of it?

Thank you very much!

Baraka

---

<div class="post-metadata">

**Author:** ![Kai\_Stian\_Olstad](https://avatars.discourse-cdn.com/v4/letter/k/e19adc/32.png) [@Kai\_Stian\_Olstad](https://forum.ansible.com/u/Kai_Stian_Olstad)\
**Post date:** [December 11, 2018, 10:32pm UTC](https://forum.ansible.com/t/with-first-found-documentation/29242/2 "2018-12-11T22:32:26Z")

</div>

[https://docs.ansible.com/ansible/2.4/playbooks\_loops.html#finding-first-matched-files](https://docs.ansible.com/ansible/2.4/playbooks_loops.html#finding-first-matched-files)

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/ansible/original/1X/1882d9a01da5d8996a862359b0913cc568a39b84.svg) [@system](https://forum.ansible.com/u/system)\
**Post date:** [December 11, 2018, 11:42pm UTC](https://forum.ansible.com/t/with-first-found-documentation/29242/3 "2018-12-11T23:42:51Z")

</div>

All the with\_ loops are actually with\_\<lookup\> constructs, you can  
find the lookup specific docs here  
[https://docs.ansible.com/ansible/latest/plugins/lookup.html](https://docs.ansible.com/ansible/latest/plugins/lookup.html).  
Specific docs for the first\_found lookup:  
[https://docs.ansible.com/ansible/latest/plugins/lookup/first\_found.html](https://docs.ansible.com/ansible/latest/plugins/lookup/first_found.html)

---

<div class="post-metadata">

**Author:** ![Baraka\_Baraka](https://avatars.discourse-cdn.com/v4/letter/b/bcef8e/32.png) [@Baraka\_Baraka](https://forum.ansible.com/u/Baraka_Baraka)\
**Post date:** [December 12, 2018, 9:27am UTC](https://forum.ansible.com/t/with-first-found-documentation/29242/4 "2018-12-12T09:27:51Z")

</div>

Thank you so much! I was searching the hell out of google 🙂 I missed these pages somehow.
