Docs    YouTube

YouTube Pro – Shortcode Use

Below is a list of available shortcode options to use within the YouTube Pro plugin.  These options are not required, and if they are not specified then the default values set on your plugins Settings and Customize pages will be used.

Basic example: [youtube-feed]

Number of columnscols1-6The number of columns for the feed for desktop. Note: This setting does not apply to feeds which already use a grid layout, such as photo, album, and video feeds. To control the number of columns in those feeds use the photocols, albumcols, and videocols settings.cols=3

Name Shortcode Attribute Options Description Example
Configure
Feed Type type channel
playlist
favorites
live
single
Type of feed to display type="channel"
type="playlist"
type="favorites"
type="live"
type=single"
Specify channel channel Display videos from a YouTube channel (channel) type=channel channel="smashballoon"
Specify playlist playlist Display videos from a specific playlist (playlist) type=playlist playlist="PLLLm1a2b3c4D6g7i8j9k_1a"
Specify favorites favorites Display the “favorites” playlist for a channel (favorites) type=favoritesfavorites="smashballoon"
live Display upcoming and currently playing live streams live="UC1a2b3c4D5F6g7i8j9k"
single Display a feed of individual videos single="ahL3sbPK1U8"
search Display a feed of matching search results search="cats"
Customize Options
Feed width width Any number + unit The width of the feed container (including the unit)  Any number with a unit like “px” or “%” width=500px
width=50%
Feed height height Any number + unit The height of the feed container (including the unit) height=500px
Feed background background background="#f00"
Info Display infoposition side
below
none
Where the information (title, description, stats) will display. eg. below, side, none infoposition="side"
infoposition="below"
infoposition="none"
CSS class class class=myfeed
Video Experience playvideo onclick When to play the video?

List layout will not play automatically. Choose whether to play the video automatically in the player or wait until the user clicks the play button after the video is loaded.

playvideo="onclick"
Info Display include playicon
title
username
views
date
stats = (likes and comments count)
description
Comma separated list of what video information (title, description, stats) will display in the feed. eg. title, description include="title, description, date"
include="date, stats"
Info Display hoverinclude title
username
views
date
stats = (likes and comments count)
description
Comma separated list of what video information (title, description, stats) will display when hovering over the video thumbnail. eg. title, stats hoverinclude="title, stats, date"
Info Display descriptionlength # of characters Maximum length of the description descriptionlength="300"
Info Display descriptiontextsize px Size of description text, size of other text will be relative to this size. 13px, 14px, inherit descriptiontextsize="13px"
descriptiontextsize="inherit"
Moderation includewords choice Show videos that have specific text or hashtag in the title or description. includewords="#cat, dog, #nice"
Moderation excludewords choice Remove videos that have specific text or hashtag in the title or description. excludewords="rabbit, #dog, purple"
Layout Options
layout How your posts are display visually. layout="list"
gridcols Videos in carousel when 480px screen width or less. gridcols="3"
gridcolsmobile Columns when 480px screen width or less. gridcolsmobile="2"
gallerycols Videos in carousel when 480px screen width or less. gallerycols="3"
gallerycolsmobile Columns when 480px screen width or less. gallerycolsmobile="2"
carouselcols Videos in carousel when 480px screen width or less. carouselcols="3"
carouselcolsmobile Columns when 480px screen width or less. carouselcolsmobile="2"
carouselrows Choose 2 rows to show two posts in a single slide. carouselrows="2"
carouselloop What happens when the last slide is reached. carouselloop="infinity"
carouselarrows Show arrows on the sides to navigate posts. carouselarrows="false"
carouselpag Show dots below carousel for an ordinal indication of which slide is being shown. carouselpag="false"
carouselautoplay Whether or not to change slides automatically on an interval. carouselautoplay="true"
carouseltime Duration in milliseconds before the slide changes. itemspacing="5px"
num The number of videos in the feed num=5
itemspacing The spacing/padding around the videos in the feed. Any number with a unit like “px” or “em”. itemspacing="5px"
Video Experience Options
playerratio Player height relative to width e.g. 9:16, 3:4 playerratio="9:16"
playvideo What the user needs to do to play a video. eg. onclick, automatically playvideo="onclick"
cta What the user sees when a video pauses or ends. eg. related, link feed cta="link"
linkurl URL for viewer to visit for the call to action. linkurl="https://my-site.com/buy-now/my-product/"
linkopentype Whether to open the page in a new window or the same window. linkopentype="newwindow"
linktext ext that appears on the call-to-action button. linktext="Buy Now"
linkcolor Button background. Turns opaque on hover. linkcolor="#0f0"]
linktextcolor Color of the text on the call-to-action-button linktextcolor="#0f0"
Custom Text Translations
viewstext The text that appears after the number of views. viewstext="times viewed"
agotext The text that appears after relative times in the past. agotext="prior"
beforedatetext The text that appears before live stream dates. beforedatetext="Watch Live"
beforestreamtimetext The text that appears before relative live stream times. beforestreamtimetext="Starting in"
minutetext Translation for singular "minute". minutetext="minuto"
minutestext Translation for plural "minutes". minutestext="minuten"
hourstext Translation for "hours". hourstext="minuten"
watchnowtext The text that appears when video is currently streaming live. watchnowtext="Now Playing"
thousandstext Text after statistics if over 1 thousand. thousandstext=" thousand"
millionstext Text after statistics if over 1 million. millionstext=" million"
Header Options
showheader Include a header for this feed. showheader="false"
showdescription Include the channel description in the header. showdescription="false"
showsubscribers Include the number of subscribers in the header. showsubscribers="false"
subscriberstext The text that appears after the number of subscribers. subscriberstext="followers"
"Load More" Button Options
showbutton nclude a "Load More" button at the bottom of the feed to load more videos. showbutton="false"
buttoncolor ackground color for the "Load More" button. Any hex color code. buttoncolor="#0f0"
buttontextcolor Text color for the "Load More" button. Any hex color code. buttontextcolor="#00f"
buttontext The text that appers on the "Load More" button. buttontext="More Videos"
"Subscribe" Button Options
showsubscribe Include a "Subscribe" button at the bottom of the feed to load more videos. showsubscribe="false"
subscribecolor Background color for the "Subscribe" button. Any hex color code. subscribecolor="#0f0"
subscribetextcolor Text color for the "Subscribe" button. Any hex color code. subscribetextcolor="#00f"
subscribetext The text that appers on the "Subscribe" button. subscribetext="Subscribe to My Channel"
Other
showpast Include past live streams if displaying a live stream feed. showpast="true"
usecustomsearch Use a custom search instead of the default search type. usecustomsearch="true"
customsearch Custom search query. customsearch="&q=gooseberry falls&order=viewCount"
support

Couldn’t find your answer in the docs?

Contact Support