woocommerce/docs/wc-cli/commands.md

3846 lines
59 KiB
Markdown

# WC CLI: Commands
## wc shop_coupon
### wc shop_coupon list
#### --context
Scope under which the request is made; determines fields present in response.
#### --page
Current page of the collection.
#### --per_page
Maximum number of items to be returned in result set. Defaults to 100 items.
#### --search
Limit results to those matching a string.
#### --after
Limit response to resources published after a given ISO8601 compliant date.
#### --before
Limit response to resources published before a given ISO8601 compliant date.
#### --exclude
Ensure result set excludes specific IDs.
#### --include
Limit result set to specific ids.
#### --offset
Offset the result set by a specific number of items.
#### --order
Order sort attribute ascending or descending.
#### --orderby
Sort collection by object attribute.
#### --code
Limit result set to resources with a specific code.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc shop_coupon create
#### --code
Coupon code. (*Required*)
#### --amount
The amount of discount. Should always be numeric, even if setting a percentage.
#### --discount_type
Determines the type of discount that will be applied.
#### --description
Coupon description.
#### --date_expires
The date the coupon expires, in the site's timezone.
#### --date_expires_gmt
The date the coupon expires, as GMT.
#### --individual_use
If true, the coupon can only be used individually. Other applied coupons will be removed from the cart.
#### --product_ids
List of product IDs the coupon can be used on.
#### --excluded_product_ids
List of product IDs the coupon cannot be used on.
#### --usage_limit
How many times the coupon can be used in total.
#### --usage_limit_per_user
How many times the coupon can be used per customer.
#### --limit_usage_to_x_items
Max number of items in the cart the coupon can be applied to.
#### --free_shipping
If true and if the free shipping method requires a coupon, this coupon will enable free shipping.
#### --product_categories
List of category IDs the coupon applies to.
#### --excluded_product_categories
List of category IDs the coupon does not apply to.
#### --exclude_sale_items
If true, this coupon will not be applied to items that have sale prices.
#### --minimum_amount
Minimum order amount that needs to be in the cart before coupon applies.
#### --maximum_amount
Maximum order amount allowed when using the coupon.
#### --email_restrictions
List of email addresses that can use this coupon.
#### --meta_data
Meta data.
#### --porcelain
Output just the id when the operation is successful.
### wc shop_coupon get [id]
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc shop_coupon update [id]
#### --id
Unique identifier for the resource.
#### --code
Coupon code.
#### --amount
The amount of discount. Should always be numeric, even if setting a percentage.
#### --discount_type
Determines the type of discount that will be applied.
#### --description
Coupon description.
#### --date_expires
The date the coupon expires, in the site's timezone.
#### --date_expires_gmt
The date the coupon expires, as GMT.
#### --individual_use
If true, the coupon can only be used individually. Other applied coupons will be removed from the cart.
#### --product_ids
List of product IDs the coupon can be used on.
#### --excluded_product_ids
List of product IDs the coupon cannot be used on.
#### --usage_limit
How many times the coupon can be used in total.
#### --usage_limit_per_user
How many times the coupon can be used per customer.
#### --limit_usage_to_x_items
Max number of items in the cart the coupon can be applied to.
#### --free_shipping
If true and if the free shipping method requires a coupon, this coupon will enable free shipping.
#### --product_categories
List of category IDs the coupon applies to.
#### --excluded_product_categories
List of category IDs the coupon does not apply to.
#### --exclude_sale_items
If true, this coupon will not be applied to items that have sale prices.
#### --minimum_amount
Minimum order amount that needs to be in the cart before coupon applies.
#### --maximum_amount
Maximum order amount allowed when using the coupon.
#### --email_restrictions
List of email addresses that can use this coupon.
#### --meta_data
Meta data.
#### --porcelain
Output just the id when the operation is successful.
### wc shop_coupon delete [id]
#### --id
Unique identifier for the resource.
#### --force
Whether to bypass trash and force deletion.
#### --porcelain
Output just the id when the operation is successful.
## wc customer_download
### wc customer_download list <customer_id>
#### --customer_id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
## wc customer
### wc customer list
#### --context
Scope under which the request is made; determines fields present in response.
#### --page
Current page of the collection.
#### --per_page
Maximum number of items to be returned in result set. Defaults to 100 items.
#### --search
Limit results to those matching a string.
#### --exclude
Ensure result set excludes specific IDs.
#### --include
Limit result set to specific IDs.
#### --offset
Offset the result set by a specific number of items.
#### --order
Order sort attribute ascending or descending.
#### --orderby
Sort collection by object attribute.
#### --email
Limit result set to resources with a specific email.
#### --role
Limit result set to resources with a specific role.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc customer create
#### --email
New user email address. (*Required*)
#### --first_name
Customer first name.
#### --last_name
Customer last name.
#### --username
New user username.
#### --password
New user password. (*Required*)
#### --billing
List of billing address data.
#### --shipping
List of shipping address data.
#### --meta_data
Meta data.
#### --porcelain
Output just the id when the operation is successful.
### wc customer get [id]
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc customer update [id]
#### --id
Unique identifier for the resource.
#### --email
The email address for the customer.
#### --first_name
Customer first name.
#### --last_name
Customer last name.
#### --username
Customer login name.
#### --password
Customer password.
#### --billing
List of billing address data.
#### --shipping
List of shipping address data.
#### --meta_data
Meta data.
#### --porcelain
Output just the id when the operation is successful.
### wc customer delete [id]
#### --id
Unique identifier for the resource.
#### --force
Required to be true, as resource does not support trashing.
#### --reassign
ID to reassign posts to.
#### --porcelain
Output just the id when the operation is successful.
## wc order_note
### wc order_note list <order_id>
#### --order_id
The order ID.
#### --context
Scope under which the request is made; determines fields present in response.
#### --type
Limit result to customers or internal notes.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc order_note create <order_id>
#### --order_id
The order ID.
#### --note
Order note content. (*Required*)
#### --customer_note
If true, the note will be shown to customers and they will be notified. If false, the note will be for admin reference only.
#### --porcelain
Output just the id when the operation is successful.
### wc order_note get <order_id> [id]
#### --id
Unique identifier for the resource.
#### --order_id
The order ID.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc order_note delete <order_id> [id]
#### --id
Unique identifier for the resource.
#### --order_id
The order ID.
#### --force
Required to be true, as resource does not support trashing.
#### --porcelain
Output just the id when the operation is successful.
## wc shop_order_refund
### wc shop_order_refund list <order_id>
#### --order_id
The order ID.
#### --context
Scope under which the request is made; determines fields present in response.
#### --page
Current page of the collection.
#### --per_page
Maximum number of items to be returned in result set. Defaults to 100 items.
#### --search
Limit results to those matching a string.
#### --after
Limit response to resources published after a given ISO8601 compliant date.
#### --before
Limit response to resources published before a given ISO8601 compliant date.
#### --exclude
Ensure result set excludes specific IDs.
#### --include
Limit result set to specific ids.
#### --offset
Offset the result set by a specific number of items.
#### --order
Order sort attribute ascending or descending.
#### --orderby
Sort collection by object attribute.
#### --parent
Limit result set to those of particular parent IDs.
#### --parent_exclude
Limit result set to all items except those of a particular parent ID.
#### --dp
Number of decimal points to use in each resource.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc shop_order_refund create <order_id>
#### --order_id
The order ID.
#### --amount
Refund amount.
#### --reason
Reason for refund.
#### --refunded_by
User ID of user who created the refund.
#### --meta_data
Meta data.
#### --line_items
Line items data.
#### --api_refund
When true, the payment gateway API is used to generate the refund.
#### --porcelain
Output just the id when the operation is successful.
### wc shop_order_refund get <order_id> [id]
#### --order_id
The order ID.
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc shop_order_refund delete <order_id> [id]
#### --order_id
The order ID.
#### --id
Unique identifier for the resource.
#### --force
Required to be true, as resource does not support trashing.
#### --porcelain
Output just the id when the operation is successful.
## wc shop_order
### wc shop_order list
#### --context
Scope under which the request is made; determines fields present in response.
#### --page
Current page of the collection.
#### --per_page
Maximum number of items to be returned in result set. Defaults to 100 items.
#### --search
Limit results to those matching a string.
#### --after
Limit response to resources published after a given ISO8601 compliant date.
#### --before
Limit response to resources published before a given ISO8601 compliant date.
#### --exclude
Ensure result set excludes specific IDs.
#### --include
Limit result set to specific ids.
#### --offset
Offset the result set by a specific number of items.
#### --order
Order sort attribute ascending or descending.
#### --orderby
Sort collection by object attribute.
#### --parent
Limit result set to those of particular parent IDs.
#### --parent_exclude
Limit result set to all items except those of a particular parent ID.
#### --status
Limit result set to orders assigned a specific status.
#### --customer
Limit result set to orders assigned a specific customer.
#### --product
Limit result set to orders assigned a specific product.
#### --dp
Number of decimal points to use in each resource.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc shop_order create
#### --parent_id
Parent order ID.
#### --status
Order status.
#### --currency
Currency the order was created with, in ISO format.
#### --customer_id
User ID who owns the order. 0 for guests.
#### --customer_note
Note left by customer during checkout.
#### --billing
Billing address.
#### --shipping
Shipping address.
#### --payment_method
Payment method ID.
#### --payment_method_title
Payment method title.
#### --transaction_id
Unique transaction ID.
#### --meta_data
Meta data.
#### --line_items
Line items data.
#### --shipping_lines
Shipping lines data.
#### --fee_lines
Fee lines data.
#### --coupon_lines
Coupons line data.
#### --set_paid
Define if the order is paid. It will set the status to processing and reduce stock items.
#### --porcelain
Output just the id when the operation is successful.
### wc shop_order get [id]
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc shop_order update [id]
#### --id
Unique identifier for the resource.
#### --parent_id
Parent order ID.
#### --status
Order status.
#### --currency
Currency the order was created with, in ISO format.
#### --customer_id
User ID who owns the order. 0 for guests.
#### --customer_note
Note left by customer during checkout.
#### --billing
Billing address.
#### --shipping
Shipping address.
#### --payment_method
Payment method ID.
#### --payment_method_title
Payment method title.
#### --transaction_id
Unique transaction ID.
#### --meta_data
Meta data.
#### --line_items
Line items data.
#### --shipping_lines
Shipping lines data.
#### --fee_lines
Fee lines data.
#### --coupon_lines
Coupons line data.
#### --set_paid
Define if the order is paid. It will set the status to processing and reduce stock items.
#### --porcelain
Output just the id when the operation is successful.
### wc shop_order delete [id]
#### --id
Unique identifier for the resource.
#### --force
Whether to bypass trash and force deletion.
#### --porcelain
Output just the id when the operation is successful.
## wc product_attribute_term
### wc product_attribute_term list <attribute_id>
#### --attribute_id
Unique identifier for the attribute of the terms.
#### --context
Scope under which the request is made; determines fields present in response.
#### --page
Current page of the collection.
#### --per_page
Maximum number of items to be returned in result set. Defaults to 100 items.
#### --search
Limit results to those matching a string.
#### --exclude
Ensure result set excludes specific ids.
#### --include
Limit result set to specific ids.
#### --order
Order sort attribute ascending or descending.
#### --orderby
Sort collection by resource attribute.
#### --hide_empty
Whether to hide resources not assigned to any products.
#### --parent
Limit result set to resources assigned to a specific parent.
#### --product
Limit result set to resources assigned to a specific product.
#### --slug
Limit result set to resources with a specific slug.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product_attribute_term create <attribute_id>
#### --attribute_id
Unique identifier for the attribute of the terms.
#### --name
Name for the resource. (*Required*)
#### --slug
An alphanumeric identifier for the resource unique to its type.
#### --description
HTML description of the resource.
#### --menu_order
Menu order, used to custom sort the resource.
#### --porcelain
Output just the id when the operation is successful.
### wc product_attribute_term get <attribute_id> [id]
#### --id
Unique identifier for the resource.
#### --attribute_id
Unique identifier for the attribute of the terms.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product_attribute_term update <attribute_id> [id]
#### --id
Unique identifier for the resource.
#### --attribute_id
Unique identifier for the attribute of the terms.
#### --name
Term name.
#### --slug
An alphanumeric identifier for the resource unique to its type.
#### --description
HTML description of the resource.
#### --menu_order
Menu order, used to custom sort the resource.
#### --porcelain
Output just the id when the operation is successful.
### wc product_attribute_term delete <attribute_id> [id]
#### --id
Unique identifier for the resource.
#### --attribute_id
Unique identifier for the attribute of the terms.
#### --force
Required to be true, as resource does not support trashing.
#### --porcelain
Output just the id when the operation is successful.
## wc product_attribute
### wc product_attribute list
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product_attribute create
#### --name
Name for the resource. (*Required*)
#### --slug
An alphanumeric identifier for the resource unique to its type.
#### --type
Type of attribute.
#### --order_by
Default sort order.
#### --has_archives
Enable/Disable attribute archives.
#### --porcelain
Output just the id when the operation is successful.
### wc product_attribute get [id]
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product_attribute update [id]
#### --id
Unique identifier for the resource.
#### --name
Attribute name.
#### --slug
An alphanumeric identifier for the resource unique to its type.
#### --type
Type of attribute.
#### --order_by
Default sort order.
#### --has_archives
Enable/Disable attribute archives.
#### --porcelain
Output just the id when the operation is successful.
### wc product_attribute delete [id]
#### --id
Unique identifier for the resource.
#### --force
Required to be true, as resource does not support trashing.
#### --porcelain
Output just the id when the operation is successful.
## wc product_cat
### wc product_cat list
#### --context
Scope under which the request is made; determines fields present in response.
#### --page
Current page of the collection.
#### --per_page
Maximum number of items to be returned in result set. Defaults to 100 items.
#### --search
Limit results to those matching a string.
#### --exclude
Ensure result set excludes specific ids.
#### --include
Limit result set to specific ids.
#### --order
Order sort attribute ascending or descending.
#### --orderby
Sort collection by resource attribute.
#### --hide_empty
Whether to hide resources not assigned to any products.
#### --parent
Limit result set to resources assigned to a specific parent.
#### --product
Limit result set to resources assigned to a specific product.
#### --slug
Limit result set to resources with a specific slug.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product_cat create
#### --name
Name for the resource. (*Required*)
#### --slug
An alphanumeric identifier for the resource unique to its type.
#### --parent
The ID for the parent of the resource.
#### --description
HTML description of the resource.
#### --display
Category archive display type.
#### --image
Image data.
#### --menu_order
Menu order, used to custom sort the resource.
#### --porcelain
Output just the id when the operation is successful.
### wc product_cat get [id]
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product_cat update [id]
#### --id
Unique identifier for the resource.
#### --name
Category name.
#### --slug
An alphanumeric identifier for the resource unique to its type.
#### --parent
The ID for the parent of the resource.
#### --description
HTML description of the resource.
#### --display
Category archive display type.
#### --image
Image data.
#### --menu_order
Menu order, used to custom sort the resource.
#### --porcelain
Output just the id when the operation is successful.
### wc product_cat delete [id]
#### --id
Unique identifier for the resource.
#### --force
Required to be true, as resource does not support trashing.
#### --porcelain
Output just the id when the operation is successful.
## wc product_review
### wc product_review list <product_id>
#### --product_id
Unique identifier for the variable product.
#### --id
Unique identifier for the variation.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product_review create <product_id>
#### --product_id
Unique identifier for the variable product.
#### --id
Unique identifier for the variation.
#### --review
Review content. (*Required*)
#### --date_created
The date the review was created, in the site's timezone.
#### --date_created_gmt
The date the review was created, as GMT.
#### --rating
Review rating (0 to 5).
#### --name
Name of the reviewer. (*Required*)
#### --email
Email of the reviewer. (*Required*)
#### --porcelain
Output just the id when the operation is successful.
### wc product_review get <product_id> [id]
#### --product_id
Unique identifier for the variable product.
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product_review update <product_id> [id]
#### --product_id
Unique identifier for the variable product.
#### --id
Unique identifier for the resource.
#### --review
The content of the review.
#### --date_created
The date the review was created, in the site's timezone.
#### --date_created_gmt
The date the review was created, as GMT.
#### --rating
Review rating (0 to 5).
#### --name
Reviewer name.
#### --email
Reviewer email.
#### --porcelain
Output just the id when the operation is successful.
### wc product_review delete <product_id> [id]
#### --product_id
Unique identifier for the variable product.
#### --id
Unique identifier for the resource.
#### --force
Whether to bypass trash and force deletion.
#### --porcelain
Output just the id when the operation is successful.
## wc product_shipping_class
### wc product_shipping_class list
#### --context
Scope under which the request is made; determines fields present in response.
#### --page
Current page of the collection.
#### --per_page
Maximum number of items to be returned in result set. Defaults to 100 items.
#### --search
Limit results to those matching a string.
#### --exclude
Ensure result set excludes specific ids.
#### --include
Limit result set to specific ids.
#### --offset
Offset the result set by a specific number of items.
#### --order
Order sort attribute ascending or descending.
#### --orderby
Sort collection by resource attribute.
#### --hide_empty
Whether to hide resources not assigned to any products.
#### --product
Limit result set to resources assigned to a specific product.
#### --slug
Limit result set to resources with a specific slug.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product_shipping_class create
#### --name
Name for the resource. (*Required*)
#### --slug
An alphanumeric identifier for the resource unique to its type.
#### --description
HTML description of the resource.
#### --porcelain
Output just the id when the operation is successful.
### wc product_shipping_class get [id]
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product_shipping_class update [id]
#### --id
Unique identifier for the resource.
#### --name
Shipping class name.
#### --slug
An alphanumeric identifier for the resource unique to its type.
#### --description
HTML description of the resource.
#### --porcelain
Output just the id when the operation is successful.
### wc product_shipping_class delete [id]
#### --id
Unique identifier for the resource.
#### --force
Required to be true, as resource does not support trashing.
#### --porcelain
Output just the id when the operation is successful.
## wc product_tag
### wc product_tag list
#### --context
Scope under which the request is made; determines fields present in response.
#### --page
Current page of the collection.
#### --per_page
Maximum number of items to be returned in result set. Defaults to 100 items.
#### --search
Limit results to those matching a string.
#### --exclude
Ensure result set excludes specific ids.
#### --include
Limit result set to specific ids.
#### --offset
Offset the result set by a specific number of items.
#### --order
Order sort attribute ascending or descending.
#### --orderby
Sort collection by resource attribute.
#### --hide_empty
Whether to hide resources not assigned to any products.
#### --product
Limit result set to resources assigned to a specific product.
#### --slug
Limit result set to resources with a specific slug.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product_tag create
#### --name
Name for the resource. (*Required*)
#### --slug
An alphanumeric identifier for the resource unique to its type.
#### --description
HTML description of the resource.
#### --porcelain
Output just the id when the operation is successful.
### wc product_tag get [id]
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product_tag update [id]
#### --id
Unique identifier for the resource.
#### --name
Tag name.
#### --slug
An alphanumeric identifier for the resource unique to its type.
#### --description
HTML description of the resource.
#### --porcelain
Output just the id when the operation is successful.
### wc product_tag delete [id]
#### --id
Unique identifier for the resource.
#### --force
Required to be true, as resource does not support trashing.
#### --porcelain
Output just the id when the operation is successful.
## wc product
### wc product list
#### --context
Scope under which the request is made; determines fields present in response.
#### --page
Current page of the collection.
#### --per_page
Maximum number of items to be returned in result set. Defaults to 100 items.
#### --search
Limit results to those matching a string.
#### --after
Limit response to resources published after a given ISO8601 compliant date.
#### --before
Limit response to resources published before a given ISO8601 compliant date.
#### --exclude
Ensure result set excludes specific IDs.
#### --include
Limit result set to specific ids.
#### --offset
Offset the result set by a specific number of items.
#### --order
Order sort attribute ascending or descending.
#### --orderby
Sort collection by object attribute.
#### --parent
Limit result set to those of particular parent IDs.
#### --parent_exclude
Limit result set to all items except those of a particular parent ID.
#### --slug
Limit result set to products with a specific slug.
#### --status
Limit result set to products assigned a specific status.
#### --type
Limit result set to products assigned a specific type.
#### --sku
Limit result set to products with a specific SKU.
#### --featured
Limit result set to featured products.
#### --category
Limit result set to products assigned a specific category ID.
#### --tag
Limit result set to products assigned a specific tag ID.
#### --shipping_class
Limit result set to products assigned a specific shipping class ID.
#### --attribute
Limit result set to products with a specific attribute.
#### --attribute_term
Limit result set to products with a specific attribute term ID (required an assigned attribute).
#### --tax_class
Limit result set to products with a specific tax class.
#### --in_stock
Limit result set to products in stock or out of stock.
#### --on_sale
Limit result set to products on sale.
#### --min_price
Limit result set to products based on a minimum price.
#### --max_price
Limit result set to products based on a maximum price.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product create
#### --name
Product name.
#### --slug
Product slug.
#### --type
Product type.
#### --status
Product status (post status).
#### --featured
Featured product.
#### --catalog_visibility
Catalog visibility.
#### --description
Product description.
#### --short_description
Product short description.
#### --sku
Unique identifier.
#### --regular_price
Product regular price.
#### --sale_price
Product sale price.
#### --date_on_sale_from
Start date of sale price, in the site's timezone.
#### --date_on_sale_from_gmt
Start date of sale price, as GMT.
#### --date_on_sale_to
End date of sale price, in the site's timezone.
#### --date_on_sale_to_gmt
End date of sale price, in the site's timezone.
#### --virtual
If the product is virtual.
#### --downloadable
If the product is downloadable.
#### --downloads
List of downloadable files.
#### --download_limit
Number of times downloadable files can be downloaded after purchase.
#### --download_expiry
Number of days until access to downloadable files expires.
#### --external_url
Product external URL. Only for external products.
#### --button_text
Product external button text. Only for external products.
#### --tax_status
Tax status.
#### --tax_class
Tax class.
#### --manage_stock
Stock management at product level.
#### --stock_quantity
Stock quantity.
#### --in_stock
Controls whether or not the product is listed as "in stock" or "out of stock" on the frontend.
#### --backorders
If managing stock, this controls if backorders are allowed.
#### --sold_individually
Allow one item to be bought in a single order.
#### --weight
Product weight (lbs).
#### --dimensions
Product dimensions.
#### --shipping_class
Shipping class slug.
#### --reviews_allowed
Allow reviews.
#### --upsell_ids
List of up-sell products IDs.
#### --cross_sell_ids
List of cross-sell products IDs.
#### --parent_id
Product parent ID.
#### --purchase_note
Optional note to send the customer after purchase.
#### --categories
List of categories.
#### --tags
List of tags.
#### --images
List of images.
#### --attributes
List of attributes.
#### --default_attributes
Defaults variation attributes.
#### --menu_order
Menu order, used to custom sort products.
#### --meta_data
Meta data.
#### --porcelain
Output just the id when the operation is successful.
### wc product get [id]
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product update [id]
#### --id
Unique identifier for the resource.
#### --name
Product name.
#### --slug
Product slug.
#### --type
Product type.
#### --status
Product status (post status).
#### --featured
Featured product.
#### --catalog_visibility
Catalog visibility.
#### --description
Product description.
#### --short_description
Product short description.
#### --sku
Unique identifier.
#### --regular_price
Product regular price.
#### --sale_price
Product sale price.
#### --date_on_sale_from
Start date of sale price, in the site's timezone.
#### --date_on_sale_from_gmt
Start date of sale price, as GMT.
#### --date_on_sale_to
End date of sale price, in the site's timezone.
#### --date_on_sale_to_gmt
End date of sale price, in the site's timezone.
#### --virtual
If the product is virtual.
#### --downloadable
If the product is downloadable.
#### --downloads
List of downloadable files.
#### --download_limit
Number of times downloadable files can be downloaded after purchase.
#### --download_expiry
Number of days until access to downloadable files expires.
#### --external_url
Product external URL. Only for external products.
#### --button_text
Product external button text. Only for external products.
#### --tax_status
Tax status.
#### --tax_class
Tax class.
#### --manage_stock
Stock management at product level.
#### --stock_quantity
Stock quantity.
#### --in_stock
Controls whether or not the product is listed as "in stock" or "out of stock" on the frontend.
#### --backorders
If managing stock, this controls if backorders are allowed.
#### --sold_individually
Allow one item to be bought in a single order.
#### --weight
Product weight (lbs).
#### --dimensions
Product dimensions.
#### --shipping_class
Shipping class slug.
#### --reviews_allowed
Allow reviews.
#### --upsell_ids
List of up-sell products IDs.
#### --cross_sell_ids
List of cross-sell products IDs.
#### --parent_id
Product parent ID.
#### --purchase_note
Optional note to send the customer after purchase.
#### --categories
List of categories.
#### --tags
List of tags.
#### --images
List of images.
#### --attributes
List of attributes.
#### --default_attributes
Defaults variation attributes.
#### --menu_order
Menu order, used to custom sort products.
#### --meta_data
Meta data.
#### --porcelain
Output just the id when the operation is successful.
### wc product delete [id]
#### --id
Unique identifier for the resource.
#### --force
Whether to bypass trash and force deletion.
#### --porcelain
Output just the id when the operation is successful.
## wc product_variation
### wc product_variation list <product_id>
#### --product_id
Unique identifier for the variable product.
#### --context
Scope under which the request is made; determines fields present in response.
#### --page
Current page of the collection.
#### --per_page
Maximum number of items to be returned in result set. Defaults to 100 items.
#### --search
Limit results to those matching a string.
#### --after
Limit response to resources published after a given ISO8601 compliant date.
#### --before
Limit response to resources published before a given ISO8601 compliant date.
#### --exclude
Ensure result set excludes specific IDs.
#### --include
Limit result set to specific ids.
#### --offset
Offset the result set by a specific number of items.
#### --order
Order sort attribute ascending or descending.
#### --orderby
Sort collection by object attribute.
#### --parent
Limit result set to those of particular parent IDs.
#### --parent_exclude
Limit result set to all items except those of a particular parent ID.
#### --slug
Limit result set to products with a specific slug.
#### --status
Limit result set to products assigned a specific status.
#### --type
Limit result set to products assigned a specific type.
#### --sku
Limit result set to products with a specific SKU.
#### --featured
Limit result set to featured products.
#### --category
Limit result set to products assigned a specific category ID.
#### --tag
Limit result set to products assigned a specific tag ID.
#### --shipping_class
Limit result set to products assigned a specific shipping class ID.
#### --attribute
Limit result set to products with a specific attribute.
#### --attribute_term
Limit result set to products with a specific attribute term ID (required an assigned attribute).
#### --tax_class
Limit result set to products with a specific tax class.
#### --in_stock
Limit result set to products in stock or out of stock.
#### --on_sale
Limit result set to products on sale.
#### --min_price
Limit result set to products based on a minimum price.
#### --max_price
Limit result set to products based on a maximum price.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product_variation create <product_id>
#### --product_id
Unique identifier for the variable product.
#### --description
Variation description.
#### --sku
Unique identifier.
#### --regular_price
Variation regular price.
#### --sale_price
Variation sale price.
#### --date_on_sale_from
Start date of sale price, in the site's timezone.
#### --date_on_sale_from_gmt
Start date of sale price, as GMT.
#### --date_on_sale_to
End date of sale price, in the site's timezone.
#### --date_on_sale_to_gmt
End date of sale price, in the site's timezone.
#### --visible
Define if the attribute is visible on the "Additional information" tab in the product's page.
#### --virtual
If the variation is virtual.
#### --downloadable
If the variation is downloadable.
#### --downloads
List of downloadable files.
#### --download_limit
Number of times downloadable files can be downloaded after purchase.
#### --download_expiry
Number of days until access to downloadable files expires.
#### --tax_status
Tax status.
#### --tax_class
Tax class.
#### --manage_stock
Stock management at variation level.
#### --stock_quantity
Stock quantity.
#### --in_stock
Controls whether or not the variation is listed as "in stock" or "out of stock" on the frontend.
#### --backorders
If managing stock, this controls if backorders are allowed.
#### --weight
Variation weight (lbs).
#### --dimensions
Variation dimensions.
#### --shipping_class
Shipping class slug.
#### --image
Variation image data.
#### --attributes
List of attributes.
#### --menu_order
Menu order, used to custom sort products.
#### --meta_data
Meta data.
#### --porcelain
Output just the id when the operation is successful.
### wc product_variation get <product_id> [id]
#### --product_id
Unique identifier for the variable product.
#### --id
Unique identifier for the variation.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc product_variation update <product_id> [id]
#### --product_id
Unique identifier for the variable product.
#### --id
Unique identifier for the variation.
#### --description
Variation description.
#### --sku
Unique identifier.
#### --regular_price
Variation regular price.
#### --sale_price
Variation sale price.
#### --date_on_sale_from
Start date of sale price, in the site's timezone.
#### --date_on_sale_from_gmt
Start date of sale price, as GMT.
#### --date_on_sale_to
End date of sale price, in the site's timezone.
#### --date_on_sale_to_gmt
End date of sale price, in the site's timezone.
#### --visible
Define if the attribute is visible on the "Additional information" tab in the product's page.
#### --virtual
If the variation is virtual.
#### --downloadable
If the variation is downloadable.
#### --downloads
List of downloadable files.
#### --download_limit
Number of times downloadable files can be downloaded after purchase.
#### --download_expiry
Number of days until access to downloadable files expires.
#### --tax_status
Tax status.
#### --tax_class
Tax class.
#### --manage_stock
Stock management at variation level.
#### --stock_quantity
Stock quantity.
#### --in_stock
Controls whether or not the variation is listed as "in stock" or "out of stock" on the frontend.
#### --backorders
If managing stock, this controls if backorders are allowed.
#### --weight
Variation weight (lbs).
#### --dimensions
Variation dimensions.
#### --shipping_class
Shipping class slug.
#### --image
Variation image data.
#### --attributes
List of attributes.
#### --menu_order
Menu order, used to custom sort products.
#### --meta_data
Meta data.
#### --porcelain
Output just the id when the operation is successful.
### wc product_variation delete <product_id> [id]
#### --product_id
Unique identifier for the variable product.
#### --id
Unique identifier for the variation.
#### --force
Whether to bypass trash and force deletion.
#### --porcelain
Output just the id when the operation is successful.
## wc setting
### wc setting get [id]
#### --group
Settings group ID.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc setting update [id]
#### --group
Settings group ID.
#### --id
Unique identifier for the resource.
#### --value
Setting value.
#### --porcelain
Output just the id when the operation is successful.
## wc shipping_zone
### wc shipping_zone list
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc shipping_zone create
#### --name
Shipping zone name. (*Required*)
#### --order
Shipping zone order.
#### --porcelain
Output just the id when the operation is successful.
### wc shipping_zone get [id]
#### --id
Unique ID for the resource.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc shipping_zone update [id]
#### --id
Unique ID for the resource.
#### --name
Shipping zone name.
#### --order
Shipping zone order.
#### --porcelain
Output just the id when the operation is successful.
### wc shipping_zone delete [id]
#### --id
Unique ID for the resource.
#### --force
Whether to bypass trash and force deletion.
#### --porcelain
Output just the id when the operation is successful.
## wc shipping_zone_location
### wc shipping_zone_location list
#### --id
Unique ID for the resource.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
## wc shipping_zone_method
### wc shipping_zone_method list
#### --zone_id
Unique ID for the zone.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc shipping_zone_method create
#### --zone_id
Unique ID for the zone.
#### --order
Shipping method sort order.
#### --enabled
Shipping method enabled status.
#### --settings
Shipping method settings.
#### --method_id
Shipping method ID. (*Required*)
#### --porcelain
Output just the id when the operation is successful.
### wc shipping_zone_method get [id]
#### --zone_id
Unique ID for the zone.
#### --instance_id
Unique ID for the instance.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc shipping_zone_method update [id]
#### --zone_id
Unique ID for the zone.
#### --instance_id
Unique ID for the instance.
#### --order
Shipping method sort order.
#### --enabled
Shipping method enabled status.
#### --settings
Shipping method settings.
#### --porcelain
Output just the id when the operation is successful.
### wc shipping_zone_method delete [id]
#### --zone_id
Unique ID for the zone.
#### --instance_id
Unique ID for the instance.
#### --force
Whether to bypass trash and force deletion.
#### --porcelain
Output just the id when the operation is successful.
## wc tax_class
### wc tax_class list
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc tax_class create
#### --name
Tax class name. (*Required*)
#### --porcelain
Output just the id when the operation is successful.
### wc tax_class delete [id]
#### --slug
Unique slug for the resource.
#### --force
Required to be true, as resource does not support trashing.
#### --porcelain
Output just the id when the operation is successful.
## wc tax
### wc tax list
#### --context
Scope under which the request is made; determines fields present in response.
#### --page
Current page of the collection.
#### --per_page
Maximum number of items to be returned in result set. Defaults to 100 items.
#### --search
Limit results to those matching a string.
#### --exclude
Ensure result set excludes specific IDs.
#### --include
Limit result set to specific IDs.
#### --offset
Offset the result set by a specific number of items.
#### --order
Order sort attribute ascending or descending.
#### --orderby
Sort collection by object attribute.
#### --class
Sort by tax class.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc tax create
#### --country
Country ISO 3166 code.
#### --state
State code.
#### --postcode
Postcode / ZIP.
#### --city
City name.
#### --rate
Tax rate.
#### --name
Tax rate name.
#### --priority
Tax priority.
#### --compound
Whether or not this is a compound rate.
#### --shipping
Whether or not this tax rate also gets applied to shipping.
#### --order
Indicates the order that will appear in queries.
#### --class
Tax class.
#### --porcelain
Output just the id when the operation is successful.
### wc tax get [id]
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc tax update [id]
#### --id
Unique identifier for the resource.
#### --country
Country ISO 3166 code.
#### --state
State code.
#### --postcode
Postcode / ZIP.
#### --city
City name.
#### --rate
Tax rate.
#### --name
Tax rate name.
#### --priority
Tax priority.
#### --compound
Whether or not this is a compound rate.
#### --shipping
Whether or not this tax rate also gets applied to shipping.
#### --order
Indicates the order that will appear in queries.
#### --class
Tax class.
#### --porcelain
Output just the id when the operation is successful.
### wc tax delete [id]
#### --id
Unique identifier for the resource.
#### --force
Required to be true, as resource does not support trashing.
#### --porcelain
Output just the id when the operation is successful.
## wc webhook_delivery
### wc webhook_delivery list
#### --webhook_id
Unique identifier for the webhook.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc webhook_delivery get [id]
#### --webhook_id
Unique identifier for the webhook.
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
## wc webhook
### wc webhook list
#### --context
Scope under which the request is made; determines fields present in response.
#### --page
Current page of the collection.
#### --per_page
Maximum number of items to be returned in result set. Defaults to 100 items.
#### --search
Limit results to those matching a string.
#### --after
Limit response to resources published after a given ISO8601 compliant date.
#### --before
Limit response to resources published before a given ISO8601 compliant date.
#### --exclude
Ensure result set excludes specific IDs.
#### --include
Limit result set to specific ids.
#### --offset
Offset the result set by a specific number of items.
#### --order
Order sort attribute ascending or descending.
#### --orderby
Sort collection by object attribute.
#### --status
Limit result set to webhooks assigned a specific status.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc webhook create
#### --name
A friendly name for the webhook.
#### --status
Webhook status.
#### --topic
Webhook topic. (*Required*)
#### --secret
Webhook secret. (*Required*)
#### --delivery_url
Webhook delivery URL. (*Required*)
#### --porcelain
Output just the id when the operation is successful.
### wc webhook get [id]
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc webhook update [id]
#### --id
Unique identifier for the resource.
#### --name
A friendly name for the webhook.
#### --status
Webhook status.
#### --topic
Webhook topic.
#### --secret
Secret key used to generate a hash of the delivered webhook and provided in the request headers. This will default is a MD5 hash from the current user's ID|username if not provided.
#### --porcelain
Output just the id when the operation is successful.
### wc webhook delete [id]
#### --id
Unique identifier for the resource.
#### --force
Required to be true, as resource does not support trashing.
#### --porcelain
Output just the id when the operation is successful.
## wc shipping_method
### wc shipping_method list
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc shipping_method get [id]
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
## wc payment_gateway
### wc payment_gateway list
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc payment_gateway get [id]
#### --id
Unique identifier for the resource.
#### --context
Scope under which the request is made; determines fields present in response.
#### --fields
Limit response to specific fields. Defaults to all fields.
#### --field
Get the value of an individual field.
#### --format
Render response in a particular format.
Default: table
Options: table, json, csv, ids, yaml, count, headers, body, envelope
### wc payment_gateway update [id]
#### --id
Unique identifier for the resource.
#### --title
Payment gateway title on checkout.
#### --description
Payment gateway description on checkout.
#### --order
Payment gateway sort order.
#### --enabled
Payment gateway enabled status.
#### --settings
Payment gateway settings.
#### --porcelain
Output just the id when the operation is successful.
## wc com
The `com` command allows interacting with the Woo.com marketplace via CLI. Connecting to the marketplace via *WooCommerce > Extensions > My Subscriptions* in your WooCommerce store is required.
### wc com extension list
Gets a list of extensions available for the store from the marketplace.
#### --format
Render output in a particular format.
Default: table
Options: table, csv, json, yaml
#### --fields
Limit the output to specific object fields.
Default: all
Options: product_slug, product_name, auto_renew, expires_on, expired, sites_max, sites_active, maxed
### wc com extension install [extension]
#### --extension
Install one plugin from the available extensions.Accepts a plugin slug
#### --force
If set, the command will overwrite any installed version of the extension without prompting for confirmation.
#### --activate
If set, after installation, the plugin will activate it.
#### --activate-network
If set, the plugin will be network activated immediately after installation
#### --insecure
Retry downloads without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack.