diff --git a/CHANGELOG.md b/CHANGELOG.md
index ee895c65ba8..49962703fc3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -48,8 +48,9 @@ Ansible Changes By Release
* Fix vault errors after 'ansible-vault edit' (https://github.com/ansible/ansible/issues/30575)
* updated api doc example to match api changes
* corrected issues with slack callback plugin
+* it is import_playbook .. not import_plays .. docs now reflect this
-
+
## 2.4 "Dancing Days" - ACTIVE DEVELOPMENT
diff --git a/docs/docsite/rst/playbooks_best_practices.rst b/docs/docsite/rst/playbooks_best_practices.rst
index aab4d114b1f..7fccf23c3b7 100644
--- a/docs/docsite/rst/playbooks_best_practices.rst
+++ b/docs/docsite/rst/playbooks_best_practices.rst
@@ -221,8 +221,8 @@ some other playbooks::
---
# file: site.yml
- - import_plays: webservers.yml
- - import_plays: dbservers.yml
+ - import_playbook: webservers.yml
+ - import_playbook: dbservers.yml
In a file like webservers.yml (also at the top level), we map the configuration of the webservers group to the roles performed by the webservers group::
diff --git a/docs/docsite/rst/roadmap/ROADMAP_2_4.rst b/docs/docsite/rst/roadmap/ROADMAP_2_4.rst
index 863550b1136..2751d6d064c 100644
--- a/docs/docsite/rst/roadmap/ROADMAP_2_4.rst
+++ b/docs/docsite/rst/roadmap/ROADMAP_2_4.rst
@@ -128,7 +128,7 @@ Runtime Check on Modules for Blacklisting
Disambiguate Includes
---------------------
-- Create import_x for 'static includes' (import_task, import_play, import_role)
+- Create import_x for 'static includes' (import_task, import_playbook, import_role)
- Any directives are applied to the 'imported' tasks
diff --git a/lib/ansible/modules/utilities/logic/_include.py b/lib/ansible/modules/utilities/logic/_include.py
index 06ad9f7e92e..e232b28bd63 100644
--- a/lib/ansible/modules/utilities/logic/_include.py
+++ b/lib/ansible/modules/utilities/logic/_include.py
@@ -20,7 +20,7 @@ module: include
short_description: include a play or task list.
deprecated:
The include action was too confusing, dealing with both plays and tasks, being both dynamic and static. This module will be removed in version 2.8.
- As alternatives use include_tasks, import_plays, import_tasks.
+ As alternatives use include_tasks, import_playbook, import_tasks.
description:
- Includes a file with a list of plays or tasks to be executed in the current playbook.
- Files with a list of plays can only be included at the top level, lists of tasks can only be included where tasks normally run (in play).
diff --git a/lib/ansible/modules/utilities/logic/import_plays.py b/lib/ansible/modules/utilities/logic/import_playbook.py
similarity index 93%
rename from lib/ansible/modules/utilities/logic/import_plays.py
rename to lib/ansible/modules/utilities/logic/import_playbook.py
index 3ccab82b8d1..b3e0b932457 100644
--- a/lib/ansible/modules/utilities/logic/import_plays.py
+++ b/lib/ansible/modules/utilities/logic/import_playbook.py
@@ -16,7 +16,7 @@ DOCUMENTATION = '''
---
author:
- "Ansible Core Team (@ansible)"
-module: import_plays
+module: import_playbook
short_description: import a playbook.
description:
- Includes a file with a list of plays to be executed.
@@ -37,7 +37,7 @@ EXAMPLES = """
- debug:
msg: "play1"
-- import_plays: otherplays.yml
+- import_playbook: otherplays.yml
- name: This DOES NOT WORK
@@ -47,7 +47,7 @@ EXAMPLES = """
msg: task1
- name: This failes because I'm inside a play already
- import_plays: stuff.yml
+ import_playbook: stuff.yml
"""
RETURN = """