> For the complete documentation index, see [llms.txt](https://developer.firmhouse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.firmhouse.com/graphql-api/api-reference/mutations/replace-subscription-products.md).

# replaceSubscriptionProducts

Replaces multiple products on one subscription in a single operation

Each existing ordered product keeps its quantity, schedule, plan, and custom price; products without a custom price use the replacement product's price. Accepts at most 100 replacements.

### Arguments

| Argument                                                                                                               | Description                                |
| ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| input ([ReplaceSubscriptionProductsInput](/graphql-api/api-reference/objects/replace-subscription-products-input.md)!) | Parameters for ReplaceSubscriptionProducts |

### ReplaceSubscriptionProductsInput Arguments

| Argument                                                                                                                      | Description                                         |
| ----------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| subscriptionId ([ID](/graphql-api/api-reference/objects/id.md)!)                                                              | ID of the subscription whose products are replaced. |
| replacements (\[[OrderedProductReplacementInput](/graphql-api/api-reference/objects/ordered-product-replacement-input.md)!]!) | Ordered products and their replacement products.    |

### Return fields

#### errors (\[[ModelValidationError](/graphql-api/api-reference/objects/model-validation-error.md)!]!)

#### orderedProducts (\[[OrderedProduct](/graphql-api/api-reference/objects/ordered-product.md)!])