Watermarks
Stay organized with collections
Save and categorize content based on your preferences.
Page Summary
A watermark resource displays an image during a channel's video playbacks, with the option to link to a target channel.
The API provides set and unset methods to upload and delete watermark images respectively.
The timing object controls when a watermark appears, using type to determine if it's measured from the start or end of a video and offsetMs for the time offset, with durationMs defining its display length.
The position object defines the watermark's location within the video, with cornerPosition specifically determining the corner.
The targetChannelId property is used to indicate the YouTube channel ID that the image links to when interacted with.
A watermark resource identifies an image that displays during playbacks of a specified channel's videos. You can also specify a target channel to which the image will link as well as timing details that determine when the watermark appears during video playbacks and the length of time it is visible.
Methods
The API supports the following methods for watermarks resources:
The following table defines the properties that appear in this resource:
Properties
timing
object
The timing object encapsulates information about the time during a video playback when a channel's watermark image will display.
timing.type
string
The timing method that determines when the watermark image is displayed during the video playback. If the value is offsetFromStart, then the offsetMs field represents an offset from the start of the video. If the value is offsetFromEnd, then the offsetMs field represents an offset from the end of the video.
timing.offsetMs
unsigned long
The time offset, specified in milliseconds, that determines when the promoted item appears during video playbacks. The type property's value determines whether the offset is measured from the start or end of the video.
timing.durationMs
unsigned long
The length of time, in milliseconds, that the watermark image should display.
position
object
The position object encapsulates information about the spatial position within the video where the watermark image will display.
position.type
string
The manner in which the promoted item is positioned in the video player.
Valid values for this property are:
corner
position.cornerPosition
string
The corner of the player where the promoted item will appear. The item always appears in the upper right corner of the player.
Valid values for this property are:
topRight
imageUrl
string
The URL for the channel's watermark image. YouTube will generate this URL and return it in the API response to a watermark.set request.
imageBytes
bytes
The size of the watermark image, in bytes.
targetChannelId
string
The YouTube channel ID of the channel that the watermark image links to.
[[["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."],[],["A watermark resource is an image displayed during a channel's video playbacks. Key actions include setting a watermark by uploading an image and specifying its `targetChannelId` for linking. The `timing` object defines when the image appears using `type`, `offsetMs`, and `durationMs`. The `position` object, set to 'corner', determines the spatial location, specifically `topRight`. Watermarks can be removed using the `unset` method. The API response provides an `imageUrl` and `imageBytes`.\n"]]
