yq
v3.x
v3.x
  • yq
  • Upgrading from V2
  • Commands
    • Read
    • Validate
    • Compare
    • Write
    • Create
    • Delete
    • Merge
    • Prefix
    • Shell Completion
  • Usage
    • Output format
    • Path Expressions
    • Value Parsing
    • Working with JSON
  • Github Page
Powered by GitBook
On this page
  • Deleting from a simple document
  • From STDIN
  • Deleting in-place
  • Multiple Documents
  • Delete from single document
  • Delete from all documents

Was this helpful?

  1. Commands

Delete

Deletes all the matching nodes for the path expression in the given yaml input

PreviousCreateNextMerge

Last updated 4 years ago

Was this helpful?

yq delete <yaml_file|-> <path_expression>

See docs for for more details.

Deleting from a simple document

Given a sample.yaml file of:

b:
  c: 2
  apples: green

then

yq d sample.yaml b.c

will output

b:
  apples: green

From STDIN

Use "-" (without quotes) in-place of a file name if you wish to pipe in input from STDIN.

cat sample.yaml | yq d - b.c

Deleting in-place

yq d -i sample.yaml b.c

will update the sample.yaml file so that the 'c' node is deleted

Multiple Documents

Delete from single document

Given a sample.yaml file of:

something: else
field: leaveMe
---
b:
  c: 2
field: deleteMe

then

yq d -d1 sample.yaml field

will output:

something: else
field: leaveMe
---
b:
  c: 2

Delete from all documents

Given a sample.yaml file of:

something: else
field: deleteMe
---
b:
  c: 2
field: deleteMeToo

then

yq d -d'*' sample.yaml field

will output:

something: else
---
b:
  c: 2
path expression