For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dev Portal
DocsAPI ReferenceLearnCommunityChangelog
DocsAPI ReferenceLearnCommunityChangelog
  • Overview
    • Quick Start
    • Sandboxes
    • Tools & SDKs
    • Support
  • Docs
      • Getting Started
      • Becoming a Partner
        • Introduction
        • Quick start
        • Channels toolkit reference
      • Metafields
      • Scripts
      • Shipping Providers
      • Tax Providers
    • Archive
    • Closed Beta Programs
Dev Portal
LogoLogo
On this page
  • Required endpoints
  • Recommended endpoints
  • Extended functionality endpoints
  • UI components
  • Required UI components
  • Recommended UI components
  • Documentation
DocsIntegrationsChannels

Channels Toolkit Reference

Was this page helpful?
Previous

Channel App Requirements

Next

Overview

Built with

This article serves as a comprehensive list of all the tools in Channels Toolkit for quick reference. For a general overview of channels and developing channel apps on BigCommerce, see Channels Introduction.

Required endpoints

All channels must integrate the following endpoints.

EndpointDescription
ChannelsCreate and manage product listings for multiple storefronts and sales channels
ListingsCreate and manage product listings for multiple storefronts and sales channels
OrdersGet and manage order data
ProductsManage products, options, variants, and modifiers

Recommended endpoints

The following endpoints are recommended for most channels.

EndpointDescription
Channel Currency AssignmentsManage channel-specific currency settings
Price ListsControl variant-level pricing by channel, customer group, etc
Store InformationGet store metadata
ShippingManage how products are shipped
WebhooksGet notified when specific events occur in a BigCommerce store
RoutesCreate and manage page routes for headless storefronts
SitesCreate and manage sites associated with a channel
SettingsRead global and channel-specific settings

Extended functionality endpoints

The following endpoints provide extended functionality to channels.

EndpointDescription
CartsCreate and manage carts
CheckoutsCreate and manage checkouts
CustomersCreate and manage customers, customer addresses, and customer attributes
CurrenciesManage accepted currencies and their display
CouponsManage coupons
Gift CertificatesManage gift certificates
Customer LoginUse SSO to log customers in
Current CustomerSecurely identify the current customer
Order Payment ActionsAuthorize, capture, and void order payments
Order TransactionsGet order payment transaction data

UI components

To assist in the rapid development of apps that match the native UI and UX of the control panel, BigCommerce provides UI components and design guidelines to developers via BigDesign—BigCommerce’s design system.

LinkDescription
BigDesign Developer PlaygroundBigDesign React component documentation and playground
BigDesign RepoGitHub repository for BigDesign components
CodeSandbox appCodeSandbox app showcasing BigDesign components
Figma Component LibraryFigma library for BigDesign components
Figma Pattern LibraryFigma library for BigDesign patterns

Required UI components

The following UI components are required for channels.

  • Typography
  • Tabs
  • Panel
  • Link
  • Icons
  • Button
  • Progress Circle
  • Badge
  • Dropdown
  • Table
  • Box

Recommended UI components

The following UI components are highly recommended for channels.

  • Alerts
  • Form
  • Input
  • Tooltip

Documentation

LinkDescription
Channels overviewHigh-level overview of channels and developing channel apps on BigCommerce
Channels guideIn-depth technical guide to building a channel app
Extending existing apps with the channels toolkitGuide to integrating the channels toolkit into existing apps
Channel app best practicesList of best practices for channel apps
Building storefront channelsGuide to creating a channel app for a headless storefront