Skip to content
Saleor
Esc
↑↓navigate↵open⌘Jpreview

Schema: Saleor 3.23.43Download SDLUpgrade guides

On this page

Channel Object

Represents channel.

type Channel implements Node & ObjectWithMetadata {
  id: ID!
  privateMetadata: [MetadataItem!]!
  privateMetafield(key: String!): String
  privateMetafields(keys: [String!]): Metadata
  metadata: [MetadataItem!]!
  metafield(key: String!): String
  metafields(keys: [String!]): Metadata
  slug: String!
  name: String!
  isActive: Boolean!
  currencyCode: String!
  hasOrders: Boolean!
  defaultCountry: CountryDisplay!
  warehouses: [Warehouse!]!
  countries: [CountryDisplay!]
  availableShippingMethodsPerCountry(countries: [CountryCode!]): [ShippingMethodsPerCountry!]
  stockSettings: StockSettings!
  orderSettings: OrderSettings!
  checkoutSettings: CheckoutSettings!
  paymentSettings: PaymentSettings!
  taxConfiguration: TaxConfiguration!
}

Interfaces

Node, ObjectWithMetadata

Fields

id

id · ID!

The ID of the channel.

privateMetadata

privateMetadata · [MetadataItem!]!

List of private metadata items. Requires staff permissions to access.

privateMetafield

privateMetafield · String

A single key from private metadata. Requires staff permissions to access.

Tip: Use GraphQL aliases to fetch multiple keys.

key

key · String!

privateMetafields

privateMetafields · Metadata

Private metadata. Requires staff permissions to access. Use keys to control which fields you want to include. The default is to include everything.

keys

keys · [String!]

metadata

metadata · [MetadataItem!]!

List of public metadata items. Can be accessed without permissions.

metafield

metafield · String

A single key from public metadata.

Tip: Use GraphQL aliases to fetch multiple keys.

key

key · String!

metafields

metafields · Metadata

Public metadata. Use keys to control which fields you want to include. The default is to include everything.

keys

keys · [String!]

slug

slug · String!

Slug of the channel.

name

name · String!

Name of the channel.

Requires one of the following permissions:AUTHENTICATED_APPAUTHENTICATED_STAFF_USER

isActive

isActive · Boolean!

Whether the channel is active.

Requires one of the following permissions:AUTHENTICATED_APPAUTHENTICATED_STAFF_USER

currencyCode

currencyCode · String!

A currency that is assigned to the channel.

Requires one of the following permissions:AUTHENTICATED_APPAUTHENTICATED_STAFF_USER

hasOrders

hasOrders · Boolean!

Whether a channel has associated orders.

Requires one of the following permissions:MANAGE_CHANNELS

defaultCountry

defaultCountry · CountryDisplay!

Default country for the channel. Default country can be used in checkout to determine the stock quantities or calculate taxes when the country was not explicitly provided.

Requires one of the following permissions:AUTHENTICATED_APPAUTHENTICATED_STAFF_USER

warehouses

warehouses · [Warehouse!]!

List of warehouses assigned to this channel.

Requires one of the following permissions:AUTHENTICATED_APPAUTHENTICATED_STAFF_USER

countries

countries · [CountryDisplay!]

List of shippable countries for the channel.

availableShippingMethodsPerCountry

availableShippingMethodsPerCountry · [ShippingMethodsPerCountry!]

Shipping methods that are available for the channel.

countries

countries · [CountryCode!]

stockSettings

stockSettings · StockSettings!

Define the stock setting for this channel.

Requires one of the following permissions:AUTHENTICATED_APPAUTHENTICATED_STAFF_USER

orderSettings

orderSettings · OrderSettings!

Channel-specific order settings.

Requires one of the following permissions:MANAGE_CHANNELSMANAGE_ORDERS

checkoutSettings

checkoutSettings · CheckoutSettings!

Channel-specific checkout settings.

Requires one of the following permissions:MANAGE_CHANNELSMANAGE_CHECKOUTS

paymentSettings

paymentSettings · PaymentSettings!

Channel-specific payment settings.

Requires one of the following permissions:MANAGE_CHANNELSHANDLE_PAYMENTS

taxConfiguration

taxConfiguration · TaxConfiguration!

Channel specific tax configuration.

Added in Saleor 3.20
Requires one of the following permissions:AUTHENTICATED_STAFF_USERAUTHENTICATED_APP

Used by


Schema: Saleor 3.23.43. Download SDL.

Last updated on August 10, 2026

Was this page helpful?