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

# Delivery​Flat​Rate​Option​Definition​Update​Input

input\_object

The input fields for updating a flat rate 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 flat rate 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​Flat​Rate​Group​Create​Input!\]](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DeliveryFlatRateGroupCreateInput)

  Rate groups to create for this shipping option.

* 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​Flat​Rate​Group​Update​Input!\]](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DeliveryFlatRateGroupUpdateInput)

  Rate groups to update for this shipping option.

***

## Input objects using this input

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

  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.flatRate](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DeliveryOptionDefinitionUpdateInput#fields-flatRate)