Table of Contents
- Where the Video Link Attribute Stands
- The Specs at a Glance
- Failure 1: Linking to a Page Instead of a File
- Failure 2: Googlebot Cannot Reach the File
- Failure 3: Wrong Duration, Size, Ratio or Resolution
- Failure 4: Content Problems Unrelated to Format
- Failure 5: Feed Mapping and Data Source Mistakes
- A Repeatable Video QA Workflow
- Measuring Whether Video Is Worth It
- Hosting Options: Where to Put the Files
- Operations: Naming, Versioning and Ownership
- Frequently Asked Questions
Where the Video Link Attribute Stands
Google introduced an optional [video_link] attribute in its 2026 product data specification update, and the Merchant Center help center states that videos submitted through it became eligible to serve starting June 30, 2026. Coverage in early November 2026, including a Merchant Center spec changelog entry, repeats the central technical rule: if you are not using a YouTube URL, the URL must point directly to a raw video file, and it should not be a link to a landing page that contains a video player.
We introduced the attribute in our earlier video link guide. This article goes deeper on a narrower question: why do video links fail and how do you fix them? A French trade site also reported in early November that legacy configuration errors now surface progressively instead of as a simple warning, which is a reminder to review your feed diagnostics regularly instead of assuming a once-approved setup will last.
Technical limits quoted below come from Google's Merchant Center product data specification and a changelog entry dated early November 2026. Specs can change, so verify against the current help page before you build a pipeline around them.
The Specs at a Glance
- URL type: a YouTube URL or a direct link to a raw video file. Not a page with an embedded player.
- Length: 6 to 240 seconds.
- File size: under 500 MB.
- Aspect ratio: 9:16, 16:9 or 1:1.
- Resolution: at least 720p (1280 by 720).
- Access: publicly reachable by Googlebot, with no restrictions in robots.txt.
That list is short but each line hides a typical failure. The rest of this article goes through them in the order in which we see merchants trip.
Failure 1: Linking to a Page Instead of a File
The most common mistake is pasting the URL of a product page, a Vimeo page or a hosted-video landing page. Those URLs return HTML, not video. Google's rule says that unless you use YouTube, the link must go straight to the file, for example a URL that ends in an .mp4 extension and that returns a video content type when requested.
A quick test: open the URL in a private browser window. If the browser plays the file by itself in a bare player, you have a raw file link. If you see a styled page with navigation, you have a landing page. You can also run curl -I against the URL and check the Content-Type header, which should be a video type such as video/mp4.
Failure 2: Googlebot Cannot Reach the File
Videos stored behind a login, a signed URL that expires, or a CDN rule that blocks unknown user agents will fail. So will files covered by Disallow rules in robots.txt. Google says the file must be publicly reachable by Googlebot without restrictions.
- Check the robots.txt of the host that serves the video, which may be a CDN domain different from your store.
- Avoid expiring signed links, or set expiry far enough ahead that re-crawls succeed.
- Make sure bot protection or hotlink protection does not block Googlebot.
- Confirm the file returns a 200 status without redirects through a login.
Remember that Google must be able to fetch the file repeatedly, not once. A link that works when you test it but is rate limited under crawl load is still a problem.
Failure 3: Wrong Duration, Size, Ratio or Resolution
Many brand videos are 15 or 30 seconds and fit easily. Failures come from two directions: very short clips under six seconds, such as looping product spins, and long unedited videos such as full tutorials above four minutes. Files exported at high bitrates can exceed the 500 MB cap, and old catalog footage can fall below 720p.
Aspect ratio mistakes are subtle. A 4:5 social video is not one of the three accepted ratios. Re-export to 9:16, 16:9 or 1:1. Keep a small set of export presets so everyone on your team produces compliant files by default.
Failure 4: Content Problems Unrelated to Format
Even a technically perfect file can be a policy problem. Video content falls under the same rules as images: no misleading claims, no prohibited products, no watermarks that promote other sites, and no content that conflicts with what the product is. If you use AI-generated footage, review our article on the expanded AI label regions.
Claims in the narration or captions are held to the same standard as claims on your product page. A supplement video that says it cures a condition can create issues far larger than a rejected video link. See supplement claims compliance if that applies to you.
Failure 5: Feed Mapping and Data Source Mistakes
If you use a plugin or feed tool, the video attribute needs a source field. Check that the field is mapped, that it is not mapped to a product page URL by default, and that variants have the right file. If your tool predates the attribute, you may need a supplemental feed. Our feed rules guide explains how to add attributes with rules, and the new attributes timeline shows what else changed.
A Repeatable Video QA Workflow
Before you publish a video link
The URL ends at a file or is a YouTube URL, never a landing page.
Opening the URL in a private window plays the video without login.
Robots.txt on the host does not block the path.
Length is between 6 and 240 seconds.
File size is under 500 MB.
Aspect ratio is 9:16, 16:9 or 1:1.
Resolution is at least 1280 by 720.
The video shows the actual product and makes no unverifiable claims.
Diagnostics shows no new video-related issues one to two days after upload.
Measuring Whether Video Is Worth It
Do not roll out video to every SKU on day one. Start with your top sellers, then compare engagement and conversion against similar products without video, as far as reporting allows. Google's AI performance reporting, covered in our AI performance insights guide, can help you see where product visibility changes. Resist concluding too much from a few days of data, especially in a seasonal peak.
Hosting Options: Where to Put the Files
Because non-YouTube links must point to a raw file, where you host matters. You have three broad options, each with tradeoffs.
- YouTube: the simplest path, since Google accepts YouTube URLs directly. The downside is that you depend on YouTube's availability and policies, and unlisted or private settings can block access.
- Your own storage or CDN: full control and a direct file URL. You need to manage bandwidth, caching and robots rules, and you should ensure the host does not require cookies or tokens.
- Platform file storage: Shopify files, WooCommerce media or similar. These often produce stable direct URLs, but check that the URL returns the file and not a redirect to a viewer page.
Whichever you choose, use stable URLs. If you replace a video, keep the same filename or update the feed at the same time, so Google never sees a link that points to nothing.
Operations: Naming, Versioning and Ownership
At scale, video links are a data management problem. Use a naming convention that ties each file to the product ID, for example the SKU followed by a version number. Store the mapping in a spreadsheet or your PIM, and generate the feed column from it. When a product changes, update the file and the mapping together.
Assign ownership. Someone should be responsible for checking Diagnostics each week for video-related issues, and for retiring videos when a product is discontinued. Orphaned links to deleted files are a frequent source of errors that nobody notices until a diagnostic report arrives.
Finally, do not forget accessibility and expectations. Provide captions where you can, keep the first seconds informative because many viewers watch muted, and make sure the video matches the product variant shown, so shoppers see the right color or configuration.
Frequently Asked Questions
Can I use a Vimeo or Wistia page link? Not as a page link. Google says non-YouTube links must point directly to a raw video file, not a landing page containing the player.
Does every product need a video? No. The attribute is optional.
Why does my video show as invalid after a few days? Check whether the link expired, the host started blocking Googlebot, or the file moved. Test the URL again from a clean browser.
Does video affect suspension risk? Not directly according to the sources we reviewed, but video content must follow the same advertising and product policies as everything else.
Where is the official spec? Google's Merchant Center product data specification and the video link attribute help page.
Catch Feed Problems Before Google Does
Format errors are easy to fix once you know where to look. A free scan at gmcunbanned.com checks your store for the policy and landing page issues that most often trigger suspensions.
Run Free GMC Scan →