---
schema_version: "1"
id: d183fd7a7520aa8e7b540508711b023f25c5dbc74af710025004e942b52931c9
title: devops work-item combine
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/salesforcedx/sfclireference/guides/devops/cli_reference_devops_work-item_combine.md
canonical_url: https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_devops_work-item_combine.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: cfb1e5c8f9bbf47fb9b795b39b7b00872af81db5223e7f7d8fc468ba0e9a3138
products:
- Salesforce CLI Command Reference
- salesforcedx
---
# devops work-item combine
Prepare work items to be combined for custom promotion.
## Description for devops work-item combine
Use this command when work items in the same stage share metadata or have dependencies. DevOps Center combines the selected work items so they can be promoted together during custom promotion.
After running this command, use "sf devops work-item promote" with the parent work item ID to complete the promotion. The combined work items are promoted as a single unit.
## Flags
| Flag Name (Long) | Flag Name (Short) | Description |
|------------------|-------------------|-------------|
| ‑‑api‑version | N/A | **Type:** Value
Override the api version used for api requests made by this command |
| ‑‑child‑work‑item‑id | N/A | **Type:** Value
**Required**
ID of a work item to combine.
Specify this flag multiple times to combine multiple work items with the parent. |
| ‑‑flags‑dir | N/A | **Type:** Value
Import flag values from a directory. |
| ‑‑json | N/A | **Type:** Boolean
Format output as json. |
| ‑‑parent‑work‑item‑id | N/A | **Type:** Value
**Required**
ID of the parent work item.
The parent work item is the primary work item that continues through the pipeline. Changes from all child work items are merged into the parent's branch during promotion. |
| ‑‑target‑org | ‑o | **Type:** Value
**Required**
Username or alias of the target org. Not required if the `target-org` configuration variable is already set. |
| ‑‑target‑stage‑id | ‑t | **Type:** Value
**Required**
ID of the pipeline stage to promote the combined work item to. |
## Examples for devops work-item combine
Prepare three work items to be combined to prevent conflicts during promotion:
```shell
sf devops work-item combine --target-org my-devops-org --parent-work-item-id 0Wx000000000001 --child-work-item-id 0Wx000000000002 --child-work-item-id 0Wx000000000003 --target-stage-id 05S000000000002
```