In a server environment based in China (WordPress), simply pasting a YouTube video URL into an article will not automatically display its thumbnail.
Under normal circumstances, WordPress supports major video platforms like YouTube, allowing you to embed videos with thumbnails just by pasting the link. However, on WordPress running on China-based servers, this auto-embed function often fails to work properly.
This issue is mainly caused by China’s network environment and related restrictions, so extra caution is needed when handling video content. In this article, we explain how to embed videos in WordPress and highlight the unique limitations of servers located in China.
Table of Contents
There are two main ways to insert videos into a WordPress post, each with its own advantages and disadvantages.
〇 Advantages:
Full control without relying on external services. Suitable for private use or websites with strict restrictions.
〇 Disadvantages:
Consumes server storage and bandwidth. May slow down site performance and page load speed.
〇 Advantages:
Saves server resources and enables smoother playback. Can increase visibility and sharing effects through social media.
〇 Disadvantages:
Dependent on external services. On China-based servers, playback and embedding may not function properly.
Below is the whitelist of video platforms supported for auto-embedding in WordPress (based on the WordPress Gutenberg editor standard):
Amazon、Animoto、Cloudup、CollegeHumor、Crowdsignal、Dailymotion、Facebook、Flickr、Hulu、Imgur、Instagram、Issuu、Kickstarter、Meetup.com、Mixcloud、Reddit、ReverbNation、Screencast、Scribd、Slideshare、SmugMug、Someecards、SoundCloud、Speaker Deck、Spotify、TED、Tumblr、VideoPress、Vimeo、WordPress.tv、X（旧：Twitter）、YouTube
In this case, we’ll use YouTube as an example.
Normally, WordPress allows you to simply paste a YouTube video link into the visual editor. Internally, WordPress uses the oEmbed API to fetch video metadata (such as the thumbnail image, video title, etc.) directly from YouTube. As a result, the link is automatically converted into an iframe tag, and a video player with a thumbnail is displayed inside the post.
However, on servers based in China, this feature does not function properly. Common issues include missing thumbnails or videos that cannot be played.
This happens due to the following technical factors:
Thumbnail images (e.g., https://img.youtube.com/vi/VIDEO_ID/hqdefault.jpg) and the oEmbed endpoint (https://www.youtube.com/oembed) are inaccessible from within China.
As a result, WordPress cannot fetch the required metadata from YouTube, and thumbnails are not generated.
When a server in China sends direct requests to YouTube, the packets may be blocked.
In particular, requests for thumbnail images are often discarded mid-transfer, which leads to empty placeholders (blank frames) being displayed instead of thumbnails.
WordPress normally caches retrieved oEmbed data in the database.
However, on China-based servers, the initial request to YouTube fails. Since no data is cached, subsequent requests also fail, leaving the thumbnail area blank.
In such cases, you need to manually embed the video URL by writing the iframe code directly in the text editor.
* However, please note that video playback itself will still be blocked when accessed from within China.
When operating WordPress in a China-based server environment, YouTube’s automatic embedding cannot be relied upon. Instead, you will need to use manual methods such as embedding videos with iframe code.
If video thumbnails fail to display, it may negatively impact the user experience for viewers. Therefore, it is recommended to choose the most suitable video delivery method based on the server location and the target audience.
● For website creation, server setup, and operation – Contact Us ●
▼ Company WeChat Official Account▼
▼ Contact person in charge WeChat ID ▼
Follow us on WeChat
【Shenzhen】 What Is the “China-Japan Exchange Meeting” That Builds Bridges Between the Two Nations?
Published a case study on updating the homepage of the “Yuwa Life” website.