---
title: AttributeInput - GraphQL Admin
description: The input fields for an attribute.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/AttributeInput
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/AttributeInput.md
api_name: admin
api_type: graphql
type: input-object
---

# Attribute​Input

input\_object

The input fields for an attribute.

## Fields

* key

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

  non-null

  Key or name of the attribute.

* value

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

  non-null

  Value of the attribute.

***

## Input objects using this input

* [Draft​Order​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-customAttributes)

  INPUT OBJECT

  The input fields used to create or update a draft order.

* [Draft​Order​Line​Item​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderLineItemInput#fields-customAttributes)

  INPUT OBJECT

  The input fields for a line item included in a draft order.

* [Order​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/OrderInput#fields-customAttributes)

  INPUT OBJECT

  The input fields for specifying the information to be updated on an order when using the orderUpdate mutation.

* [Subscription​Contract​Calculation​Billing​Cycle​Edit​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationBillingCycleEditInput#fields-customAttributes)

  INPUT OBJECT

  The input fields for editing a subscription contract for a single billing cycle, used for contract calculation. Any field provided will update or replace the corresponding value for the targeted cycle. Fields that are omitted will be left unchanged. Contract-level attributes such as billing policy, delivery policy, and payment method cannot be changed by a billing cycle edit.

* [Subscription​Contract​Calculation​Contract​Create​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationContractCreateInput#fields-customAttributes)

  INPUT OBJECT

  The input fields for calculating a new subscription contract. Provide the complete desired state of the contract. The contract isn't created until you commit the calculation with the [`subscriptionContractCalculationCommit`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCalculationCommit) mutation.

  Learn how to [build a subscription contract](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/build-a-subscription-contract).

* [Subscription​Contract​Calculation​Contract​Update​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationContractUpdateInput#fields-customAttributes)

  INPUT OBJECT

  The input fields for calculating changes to an existing subscription contract. Each field you provide replaces the corresponding value on the contract, and omitted fields remain unchanged. For list fields, provide the complete replacement list, including the `id` of each existing item that you want to keep.

  Learn how to [update a subscription contract](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/update-a-subscription-contract).

* [Subscription​Contract​Calculation​Custom​Line​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationCustomLineInput#fields-customAttributes)

  INPUT OBJECT

  The input fields for custom subscription lines in the calculate API.

* [Subscription​Contract​Calculation​Product​Variant​Line​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationProductVariantLineInput#fields-customAttributes)

  INPUT OBJECT

  The input fields for product variant subscription lines in the calculate API.

* [Subscription​Contract​Calculation​Product​Variant​Parent​Line​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationProductVariantParentLineInput#fields-customAttributes)

  INPUT OBJECT

  The input fields for product variant bundle parent subscription lines in the calculate API.

* [Subscription​Draft​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionDraftInput#fields-customAttributes)

  INPUT OBJECT

  The input fields required to create a Subscription Draft.

* [Subscription​Line​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionLineInput#fields-customAttributes)

  INPUT OBJECT

  The input fields required to add a new subscription line to a contract.

* [Subscription​Line​Update​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionLineUpdateInput#fields-customAttributes)

  INPUT OBJECT

  The input fields required to update a subscription line on a contract.

***

## Map

### Input objects using this input

* [Draft​Order​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-customAttributes)
* [Draft​Order​Line​Item​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderLineItemInput#fields-customAttributes)
* [Order​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/OrderInput#fields-customAttributes)
* [Subscription​Contract​Calculation​Billing​Cycle​Edit​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationBillingCycleEditInput#fields-customAttributes)
* [Subscription​Contract​Calculation​Contract​Create​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationContractCreateInput#fields-customAttributes)
* [Subscription​Contract​Calculation​Contract​Update​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationContractUpdateInput#fields-customAttributes)
* [Subscription​Contract​Calculation​Custom​Line​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationCustomLineInput#fields-customAttributes)
* [Subscription​Contract​Calculation​Product​Variant​Line​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationProductVariantLineInput#fields-customAttributes)
* [Subscription​Contract​Calculation​Product​Variant​Parent​Line​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationProductVariantParentLineInput#fields-customAttributes)
* [Subscription​Draft​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionDraftInput#fields-customAttributes)
* [Subscription​Line​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionLineInput#fields-customAttributes)
* [Subscription​Line​Update​Input.customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionLineUpdateInput#fields-customAttributes)