ChannelSections
Stay organized with collections
Save and categorize content based on your preferences.
Page Summary
A channelSection resource contains information about a set of videos that a channel features, such as latest uploads, popular uploads, or playlists.
Channels can manage their featured videos using the API, which allows creating, listing, updating, and deleting channelSection resources.
A channel can have a maximum of 10 sections, each with a specified type like singlePlaylist, multipleChannels, or popularUploads.
Each channelSection has properties such as kind, etag, id, snippet, and contentDetails, which specify details about the section and its contents.
The contentDetails property can contain a list of either playlists or channels featured in the section, depending on the snippet.type property.
A channelSection resource contains information about a set of
videos that a channel has chosen to feature. For example, a section could feature a channel's
latest uploads, most popular uploads, or videos from one or more playlists.
A channel can create a maximum of 10 shelves.
Methods
The API supports the following methods for channelSections resources:
The following table defines the properties that appear in this resource:
Properties
kind
string
Identifies the API resource's type. The value will be youtube#channelSection.
etag
etag
The Etag of this resource.
id
string
The ID that YouTube uses to uniquely identify the channel section.
snippet
object
The snippet object contains basic details about the channel section, such as its type and title.
snippet.type
string
The channel section's type.
Valid values for this property are:
allPlaylists
completedEvents
liveEvents
multipleChannels
multiplePlaylists
popularUploads
recentUploads
singlePlaylist
subscriptions
upcomingEvents
snippet.channelId
string
The ID that YouTube uses to uniquely identify the channel that published the channel section.
snippet.title
string
The section's title. You can only set the title of a channel section that has a snippet.type value of either multiplePlaylists or multipleChannels, and, in fact, you must specify a title when inserting or updating either of those types of sections. If you specify a title for other types of channel sections, the value will be ignored.
This property's value has a maximum length of 100 characters and may contain all valid UTF-8 characters except < and >.
snippet.position
unsigned integer
The section's position on the channel page. This property uses a 0-based index. A value of 0 identifies the first section that appears on the channel, a value of 1 identifies the second section, and so forth.
If you do not specify a value for this property when inserting a channel section, the default behavior is to display the new section last.
contentDetails
object
The contentDetails object contains details about the channel section's content, such as a list of playlists or channels featured in the section.
contentDetails.playlists[]
list
A list of one or more playlist IDs that are featured in a channel section. You must specify a list of playlist IDs if the channelSection resource's snippet.type property is either singlePlaylist or multiplePlaylists, and this property should not be specified for other types of sections. If the type is singlePlaylist, this list must specify exactly one playlist ID.
contentDetails.channels[]
list
A list of one or more channel IDs that are featured in a channel section. You must specify a list of channel IDs if the channelSection resource's snippet.type property is multipleChannels, and this property should not be specified for other types of sections. You cannot include your own channel in the list.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],["Channel sections feature a curated set of videos, like latest or popular uploads, or playlists. API methods allow listing, inserting, updating, and deleting these sections. A channel can have up to 10 sections. Each section contains `snippet` and `contentDetails` objects which describes the type, title, position, and the featured channels/playlists. The type can be single or multiple playlists, or channels, amongst others. Specific titles are required for some types and cannot include \"\u003c\" or \"\u003e\".\n"]]
