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

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

input\_object

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

## Fields

* currency

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

  non-null

  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. Currency must match the shipping option's currency.

* is​Active

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

  Default:true

  Whether this shipping option is active and shown to buyers. Defaults to true.

* name

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

  non-null

  The name shown to buyers for this shipping option.

* rate​Groups

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

  required

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

***

## Input objects using this input

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

  INPUT OBJECT

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

***

## Map

### Input objects using this input

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