---
title: ChannelDefinition - GraphQL Admin
description: |-
  A channel definition represents channels surfaces on the platform.
  A channel definition can be a platform or a subsegment of it such as Facebook Home, Instagram Live, Instagram Shops, or WhatsApp chat.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/ChannelDefinition
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/ChannelDefinition.md
---

# Channel​Definition

object

A channel definition represents channels surfaces on the platform. A channel definition can be a platform or a subsegment of it such as Facebook Home, Instagram Live, Instagram Shops, or WhatsApp chat.

## Fields

* channel​Name

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

  non-null

  Name of the channel that this sub channel belongs to.

* handle

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

  non-null

  Unique string used as a public identifier for the channel definition.

* id

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

  non-null

  The unique ID for the channel definition.

* is​Marketplace

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

  non-null

  Whether this channel definition represents a marketplace.

* sub​Channel​Name

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

  non-null

  Name of the sub channel (e.g. Online Store, Instagram Shopping, TikTok Live).

* svg​Icon

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

  Deprecated

***

## Map

### Fields with this object

* {}[AvailableChannelDefinitionsByChannel.channelDefinitions](https://shopify.dev/docs/api/admin-graphql/latest/objects/AvailableChannelDefinitionsByChannel#field-AvailableChannelDefinitionsByChannel.fields.channelDefinitions)
* {}[ChannelInformation.channelDefinition](https://shopify.dev/docs/api/admin-graphql/latest/objects/ChannelInformation#field-ChannelInformation.fields.channelDefinition)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)

  interface

***

## ||-ChannelDefinition Implements

### Implements

* ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)