Creates a new lesson.

OPTIONS #OPTIONS

[--date_created=<date_created>]

Creation date. Format: Y-m-d H:i:s

[--date_created_gmt=<date_created_gmt>]

Creation date (in GMT). Format: Y-m-d H:i:s

[--menu_order=<menu_order>]

Creation date (in GMT). Format: Y-m-d H:i:s
---
default: 0
---

--title=<title>

Post title.

--content=<content>

The HTML content of the post.

[--excerpt=<excerpt>]

The HTML excerpt of the post.

[--slug=<slug>]

Post URL slug.

[--status=<status>]

The publication status of the post.
---
default: publish
options:
– publish
– future
– draft
– pending
– private
---

[--password=<password>]

Password used to protect access to the content.

[--featured_media=<featured_media>]

Featured image ID.

[--comment_status=<comment_status>]

Post comment status. Default comment status dependent upon general WordPress post discussion settings.
---
default: open
options:
– open
– closed
---

[--ping_status=<ping_status>]

Post ping status. Default ping status dependent upon general WordPress post discussion settings.
---
default: open
options:
– open
– closed
---

[--parent_id=<parent_id>]

WordPress post ID of the parent item. Must be a Section ID. 0 indicates an “orphaned” lesson which can be edited and viewed by instructors and admins but cannot be read by students.

--order=<order>

Order of the lesson within its immediate parent.
---
default: 1
---

[--prerequisite=<prerequisite>]

Lesson ID of the prerequisite lesson.

[--points=<points>]

Determines the weight of the lesson when grading the course.
---
default: 1
---

[--audio_embed=<audio_embed>]

URL to an oEmbed enable audio URL.

[--video_embed=<video_embed>]

URL to an oEmbed enable video URL.

[--drip_date=<drip_date>]

The date and time when the lesson becomes available. Applicable only when drip_method is date. Format: Y-m-d H:i:s.

[--drip_days=<drip_days>]

Number of days to wait before allowing access to the lesson. Applicable only when drip_method is enrollment, start, or prerequisite.
---
default: 1
---

[--drip_method=<drip_method>]

Determine the method with which to make the lesson content available.
<ul>
<li>none: Drip is disabled; the lesson is immediately available.</li>
<li>date: Lesson is made available at a specific date and time.</li>
<li>enrollment: Lesson is made available a specific number of days after enrollment into the course.</li>
<li>start: Lesson is made available a specific number of days after the course’s start date. Only available on courses with a access_opens_date.</li>
<li>prerequisite: Lesson is made available a specific number of days after the prerequisite lesson is completed.</li>
</ul>
---
default: none
options:
– none
– date
– enrollment
– start
– prerequisite
---

[--public=<public>]

Denotes a lesson that’s publicly accessible regardless of course enrollment.
---
default: false
---

[--quiz=<quiz>]

Associate a quiz with this lesson.

[--porcelain]

Output just the id when the operation is successful.

Top ↑

GLOBAL PARAMETERS #GLOBAL PARAMETERS

These global parameters have the same behavior across all commands and affect how WP-CLI interacts with WordPress.

Argument	Description
--path=<path>	Path to the WordPress files.
--url=<url>	Pretend request came from given URL. In multisite, this argument is how the target site is specified.
--ssh=[<scheme>:][<user>@]<host\|container>[:<port>][<path>]	Perform operation against a remote server over SSH (or a container using scheme of “docker”, “docker-compose”, “vagrant”).
--http=<http>	Perform operation against a remote WordPress installation over HTTP.
--user=<id\|login\|email>	Set the WordPress user.
--skip-plugins[=<plugins>]	Skip loading all plugins, or a comma-separated list of plugins. Note: mu-plugins are still loaded.
--skip-themes[=<themes>]	Skip loading all themes, or a comma-separated list of themes.
--skip-packages	Skip loading all installed packages.
--require=<path>	Load PHP file before running the command (may be used more than once).
--exec=<php-code>	Execute PHP code before running the command (may be used more than once).
--[no-]color	Whether to colorize the output.
--debug[=<group>]	Show all PHP errors and add verbosity to WP-CLI output. Built-in groups include: bootstrap, commandfactory, and help.
--prompt[=<assoc>]	Prompt the user to enter values for all command arguments, or a subset specified as comma-separated values.
--quiet	Suppress informational messages.