Skip to main content

Settings Schema

When uploading a video to YouTube, use the following settings schema:

Fields

FieldTypeRequiredDescription
__typestringYesMust be youtube
titlestringYesVideo title (2-100 characters)
typestringYesVideo visibility
selfDeclaredMadeForKidsstringNoMade for kids declaration
thumbnailobjectNoCustom thumbnail
tagsarrayNoVideo tags

title

Video title with the following constraints:
  • Minimum: 2 characters
  • Maximum: 100 characters

type (visibility)

ValueDescription
publicAnyone can search for and view
unlistedAnyone with the link can view
privateOnly you can view

selfDeclaredMadeForKids

ValueDescription
yesContent is made for kids
noContent is not made for kids

thumbnail

Custom thumbnail object (uploaded via the uploads endpoint):

tags

Array of tag objects for video SEO:

Complete Example

Public Video with Tags

Video with Custom Thumbnail

Private/Unlisted Video