# Valid play parameters/attributes list

**URL:** <https://forum.ansible.com/t/valid-play-parameters-attributes-list/23927>\
**Category:** Ansible Project\
**Created:** [March 9, 2017, 7:53pm UTC](https://forum.ansible.com/t/valid-play-parameters-attributes-list/23927 "2017-03-09T19:53:21Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![Keith\_Gunderson](https://avatars.discourse-cdn.com/v4/letter/k/e495f1/32.png) [@Keith\_Gunderson](https://forum.ansible.com/u/Keith_Gunderson)\
**Post date:** [March 9, 2017, 7:53pm UTC](https://forum.ansible.com/t/valid-play-parameters-attributes-list/23927/1 "2017-03-09T19:53:21Z")

</div>

Please direct me to a listing of valid play attributes. Also, what is the preferred term for these, attributes or parameters? I’ve wondered this before and thought it must be an oversight in the docs.

My current issue is related to putting a “when” attribute at the play level and receiving the following:

ERROR! ‘when’ is not a valid attribute for a Play

Thank you,  
K.G.

---

<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:** [March 10, 2017, 3:04pm UTC](https://forum.ansible.com/t/valid-play-parameters-attributes-list/23927/2 "2017-03-10T15:04:38Z")

</div>

[https://docs.ansible.com/ansible/playbooks\_directives.html](https://docs.ansible.com/ansible/playbooks_directives.html)

---

<div class="post-metadata">

**Author:** ![Brian\_Coca](https://avatars.discourse-cdn.com/v4/letter/b/6de8d8/32.png) [@Brian\_Coca](https://forum.ansible.com/u/Brian_Coca)\
**Post date:** [March 10, 2017, 4:41pm UTC](https://forum.ansible.com/t/valid-play-parameters-attributes-list/23927/3 "2017-03-10T16:41:15Z")

</div>

I prefer directives, others prefer command/keywords/attributes ... we  
might just need to sit down a create a 'project default name' for  
these

---

<div class="post-metadata">

**Author:** ![Keith\_Gunderson](https://avatars.discourse-cdn.com/v4/letter/k/e495f1/32.png) [@Keith\_Gunderson](https://forum.ansible.com/u/Keith_Gunderson)\
**Post date:** [March 11, 2017, 2:07am UTC](https://forum.ansible.com/t/valid-play-parameters-attributes-list/23927/4 "2017-03-11T02:07:51Z")

</div>

Thank you. Any other suggestions (or not) for highlighting or simplifying the data presentation for this?

Is directive the choice for naming this? I could add an issue if would help. Ideally I could post a fix soon after 🙂

---

<div class="post-metadata">

**Author:** ![Brian\_Coca](https://avatars.discourse-cdn.com/v4/letter/b/6de8d8/32.png) [@Brian\_Coca](https://forum.ansible.com/u/Brian_Coca)\
**Post date:** [March 11, 2017, 2:28am UTC](https://forum.ansible.com/t/valid-play-parameters-attributes-list/23927/5 "2017-03-11T02:28:40Z")

</div>

I brought it up with core, we will probably discuss in public IRC  
meeting next week.