wp post block import

Note: This command is not part of a stable WP-CLI release yet. To use it now, switch to the nightly build with wp cli update --nightly. If you installed the command as a separate package, updating that package may be enough.

Options

<id>

The ID of the post to import blocks into.

[–file=<file>]

Input file path. If not specified, reads from STDIN.

[–position=<position>]

Where to insert imported blocks. Accepts ‘start’, ‘end’, or a numeric index. — default: end —

[–replace]

Replace all existing blocks instead of appending.

[–porcelain]

Output just the number of blocks imported.

Examples

# Import blocks from a JSON file, append to end of post.
$ wp post block import 123 --file=blocks.json
Success: Imported 5 blocks into post 123.

# Import blocks at the beginning of the post.
$ wp post block import 123 --file=blocks.json --position=start
Success: Imported 5 blocks into post 123.

# Replace all existing content with imported blocks.
$ wp post block import 123 --file=blocks.json --replace
Success: Imported 5 blocks into post 123.

# Import from STDIN (piped from another command).
$ cat blocks.json | wp post block import 123
Success: Imported 5 blocks into post 123.

# Copy blocks from one post to another.
$ wp post block export 123 | wp post block import 456
Success: Imported 5 blocks into post 456.

# Import YAML format.
$ wp post block import 123 --file=blocks.yaml
Success: Imported 3 blocks into post 123.

# Get just the count of imported blocks for scripting.
$ wp post block import 123 --file=blocks.json --porcelain
5

Global Parameters