---
title: DeliveryWeightBasedOptionDefinitionUpdateInput - GraphQL Admin
description: The input fields for updating a weight-based shipping option.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DeliveryWeightBasedOptionDefinitionUpdateInput
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DeliveryWeightBasedOptionDefinitionUpdateInput.md
api_name: admin
api_type: graphql
type: input-object
---

# Delivery​Weight​Based​Option​Definition​Update​Input

input\_object

The input fields for updating a weight-based shipping option.

## Fields

* currency

  [Currency​Code](https://shopify.dev/docs/api/admin-graphql/latest/enums/CurrencyCode)

  The currency used for all money values in this shipping option.

* description

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  Optional description shown to buyers.

* free​Delivery​Minimum​Value

  [Money​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/MoneyInput)

  The cart subtotal required for free shipping. Null clears the threshold. Currency must match the shipping option's currency.

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  The globally unique ID of the weight-based shipping option to update.

* is​Active

  [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  Whether this shipping option is active and shown to buyers.

* name

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The name shown to buyers for this shipping option.

* rate​Groups​To​Create

  [\[Delivery​Weight​Based​Rate​Group​Create​Input!\]](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DeliveryWeightBasedRateGroupCreateInput)

  Rate groups to create for this shipping option. At this time, only a single rate group is supported for weight-based shipping options.

* rate​Groups​To​Delete

  [\[ID!\]](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  The IDs of rate groups to delete from this shipping option.

* rate​Groups​To​Update

  [\[Delivery​Weight​Based​Rate​Group​Update​Input!\]](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DeliveryWeightBasedRateGroupUpdateInput)

  Rate groups to update for this shipping option. Only the existing single rate group is supported.

***

## Input objects using this input

* [Delivery​Option​Definition​Update​Input.weightBased](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DeliveryOptionDefinitionUpdateInput#fields-weightBased)

  INPUT OBJECT

  The input fields for updating a shipping option. Provide exactly one option type.

***

## Map

### Input objects using this input

* [Delivery​Option​Definition​Update​Input.weightBased](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DeliveryOptionDefinitionUpdateInput#fields-weightBased)