MSN HTML guidelines and tag restrictions
This page outlines MSN HTML formatting guidelines and restrictions for feed content submitted in MSN Partner Hub. Follow these standards to ensure successful ingestion and optimal display on MSN.
In this article
Where HTML is allowed
HTML is permitted in the following fields:
-
The body of articles
-
The description field of slideshow slides
HTML is not supported in other feed fields, including metadata elements such as titles, author names, or category labels.
Allowed HTML tags
Use only the supported tags below to ensure your content renders correctly.
Text Formatting
-
<b>, <i>, <em>, <strong>, <sub>, <sup>, <small>
Headings
-
<h1> through <h5>
Links
-
<a> (with href; must begin with https://, http://, or mailto:)
Images
-
<img> (must use absolute URLs)
Tables
-
<table>, <thead>, <tbody>, <tfoot>, <tr>, <td>, <th>, <col>, <caption>, <colgroup>
Lists
-
<ul>, <ol>, <li>
Layout
-
<p>, <div>, <span>, <br>
Embeds (Limited)
-
<blockquote>, <iframe> (only for supported video and social platforms — see below)
Disallowed HTML tags
The following tags will be stripped automatically during ingestion and may prevent successful publishing:
-
<style>, <script>, <object>, <embed>, <param>, <applet>
-
Any <media> tags not properly formed (e.g., missing required attributes)
-
Promotional wrappers added by third-party services (e.g., Giphy wrappers)
Best practices
-
Avoid deeply nested structures (keep HTML hierarchy below 10 levels).
-
Do not use multiple <br> tags in a row for spacing.
-
Refrain from including inline style or JavaScript.
Supported embeds
You may use <iframe> or platform-specific embed code only for these services:
-
YouTube
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Spotify
-
Infogram
-
Google Maps
-
Giphy
-
Flourish
-
Reddit
-
TikTok
All embeds must use https:// URLs. Embed code from unsupported services will be removed during processing.
Media RSS and feed markup examples
Media RSS can be used in both RSS and ATOM feeds to display media content like images and video on MSN.
The <media:content> tag is used for embedding images and videos in articles. This tag cannot be combined with HTML elements, so it must be specified at the item’s root level. Media RSS tags must be specified as immediate children of <item> in RSS or <entry> in ATOM feeds, or they will be ignored.
<media:content
url="https://contoso.com/image-source.jpg"
type="image/jpeg"
medium="image">
<media:title>Image title</media:title>
<media:text>Image1 alt-text</media:text>
<media:credit>Joe Gargery/Fabrikam Images</media:credit>
</media:content>
<media:content
url="https://contoso.com/video.mp4"
duration="91"
type="video/mp4"
medium="video">
<media:title>Video title</media:title>
<media:description>Video abstract/description</media:description>
<media:credit>Joe Gargery/Fabrikam Videos</media:credit>
</media:content>
Galleries can be embedded in articles using the <media:group> tag. This acts as a container for slides tagged as <media:content>.
<media:group>
<media:title>Slideshow title</media:title>
<media:credit role="author">Slideshow author</media:credit>
<media:content
url="https://contoso.com/image1.jpg"
type="image/jpeg"
medium="image">
<media:title>Slide 1 title</media:title>
<media:text>Slide 1 alt-text</media:text>
<media:description>Slide 1 description</media:description>
</media:content>
<media:content
url="https://contoso.com/image2.jpg"
type="image/jpeg"
medium="image">
<media:title>Slide 2 title</media:title>
<media:text>Slide 2 alt-text</media:text>
<media:description>Slide 2 description</media:description>
</media:content>
</media:group>
ATOM and RSS code examples
Use the code snippets below to help you manage your feeds. Remember to use MSN Partner Hub to preview your content and spot any rendering issues.
Please note that ATOM only supports Articles at the <entry> level. Slideshows and Videos may be embedded inline within an article.
Feed header (required structure)
<?xml version="1.0" encoding="utf-8"?>
<!-- The root element must include declaration of used namespaces. -->
<feed xmlns="http://www.w3.org/2005/Atom"
xmlns:media="http://search.yahoo.com/mrss/"
xmlns:mi="http://schemas.ingestion.microsoft.com/common/"
xmlns:dcterms="http://purl.org/dc/terms/"
xml:lang="en-us">
<id>https://v3spec.msn.com/myfeed.xml</id>
<title><![CDATA[Feed title]]></title>
<subtitle><![CDATA[Feed subtitle]]></subtitle>
<updated>2017-10-02T13:00:00.52Z</updated>
<author>
<name>Feed author</name>
<email>author@contoso.com</email>
</author>
Basic article entry
<entry>
<!-- REQUIRED: Unique ID for this article -->
<id>https://v3spec.msn.com/article123.htm</id>
<!-- REQUIRED: Title -->
<title><![CDATA[High-definition video encoding and streaming]]></title>
<!-- REQUIRED: Publish date -->
<published>2017-01-10T10:00:00+0100</published>
<!-- Last update date -->
<updated>2017-10-02T13:00:00.52Z</updated>
<!-- REQUIRED: Canonical link -->
<link rel="self" href="https://v3spec.msn.com/article123.htm" />
<!-- Author information -->
<author>
<name><![CDATA[Joe Gargery]]></name>
</author>
<!-- Optional subtitle -->
<dcterms:alternative>Article subtitle</dcterms:alternative>
Expiration options
<!-- Option 1: Using dcterms:valid -->
<dcterms:valid>
start=2016-10-01T10:00:00+0100;
end=2018-10-02T10:00:00+0100;
scheme=W3C-DTF
</dcterms:valid>
<!-- Option 2: Using mi:expirationDate -->
<mi:expirationDate>2018-10-02T13:00:00.52Z</mi:expirationDate>
Categorization and metadata
<!-- Short title (<= 40 chars) -->
<mi:shortTitle><![CDATA[Short Title]]></mi:shortTitle>
<!-- Keywords -->
<media:keywords>keyword1,keyword2,keyword3</media:keywords>
<!-- Categories -->
<category term="News" />
<category term="Sports" />
Summary and body content
<!-- Plain text abstract -->
<summary><![CDATA[ Article abstract/description should be plain text, no HTML is allowed ]]></summary>
<!-- HTML-formatted body (use CDATA to avoid escaping HTML) -->
<content type="html">
<![CDATA[
<p>Media Services enables you to encode your media files...</p>
<img src="https://v3spec.msn.com/_files/assets/azure1.jpg"
alt="Image title"
title="Image title"
data-portal-copyright="Joe Gargery/Fabrikam Images"
data-has-syndication-rights="1"
data-license-id="698526"
data-licensor-name="Licensor name"
data-focal-region="x1:246,y1:140,x2:246,y2:140" />
]]>
</content>
Inline media examples
Inline video (1PP)
<video id="8172818"
title="an inline video"
poster="https://contoso.com/videothumbnail.jpg"
data-description="this is a sample inline video">
<source src="https://contoso.com/video.mp4" type="video/mp4"/>
</video>
Inline video (3PP YouTube)
<iframe width="100%" height="100%"
frameborder="0"
allowfullscreen="true"
src="https://www.youtube.com/embed/XnZ_J3l_0z4?rel=0">
</iframe>
Inline slideshow
<div class="slideshow">
<cite>Slideshow author</cite>
<title>Slideshow title</title>
<figure>
<img src="https://v3spec.msn.com/image1.jpg" title="slide 1 title"/>
<figcaption>slide 1 caption <span class="copyright">slide 1 copyrights</span></figcaption>
</figure>
<figure>
<img src="https://v3spec.msn.com/image2.jpg" title="slide 2 title"/>
<figcaption>slide 2 caption <span class="copyright">Joe Gargery/Fabrikam Images</span></figcaption>
</figure>
</div>
Media:Content examples
<!-- Image -->
<media:content url="https://v3spec.msn.com/image1.jpg" type="image/jpeg" medium="image">
<media:credit>Joe Gargery/Fabrikam Images</media:credit>
<media:title>Image title</media:title>
<media:text>Image alt-text</media:text>
<mi:focalRegion>
<mi:x1>120</mi:x1><mi:y1>120</mi:y1>
<mi:x2>400</mi:x2><mi:y2>400</mi:y2>
</mi:focalRegion>
<mi:hasSyndicationRights>1</mi:hasSyndicationRights>
<mi:licenseId>698525</mi:licenseId>
<mi:licensorName>Licensor name</mi:licensorName>
</media:content>
<!-- Video -->
<media:content url="https://v3spec.msn.com/video.mp4" duration="91" type="video/mp4" medium="video">
<guid>218736</guid>
<media:thumbnail url="https://v3spec.msn.com/image.jpg"/>
<media:title>Video title</media:title>
<media:description>Video description</media:description>
<media:credit>Joe Gargery/Fabrikam Videos</media:credit>
</media:content>
Related links example
<link rel="related" type="text/html"
href="https://v3spec.msn.com/news/prop_irs_1.html"
title="New IRS proposal">
<media:thumbnail url="https://v3spec.msn.com/related_link_thumbnail1.jpg"/>
</link>
Example of takedown entry
<entry>
<!-- REQUIRED: Unique identifier of content to remove -->
<id>https://v3spec.msn.com/article123.htm</id>
<updated>2017-10-02T13:00:00.52Z</updated>
<!-- Expiration in the past = takedown -->
<dcterms:valid>
start=2019-10-01T10:00:00+0100;
end=2018-10-02T10:00:00+0100;
scheme=W3C-DTF
</dcterms:valid>
</entry>
</feed>
<?xml version="1.0" encoding="utf-8"?>
<rss xmlns:atom="http://www.w3.org/2005/Atom"
xmlns:media="http://search.yahoo.com/mrss/"
xmlns:mi="http://schemas.ingestion.microsoft.com/common/"
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:content="http://purl.org/rss/1.0/modules/content/"
xmlns:dcterms="http://purl.org/dc/terms/"
version="2.0">
<channel>
<!-- Channel metadata -->
<title>Lifestyle</title> <!-- REQUIRED -->
<description>Channel description</description> <!-- REQUIRED -->
<language>en-us</language> <!-- REQUIRED -->
<link>https://v3spec.msn.com/lifestyle</link> <!-- REQUIRED -->
<!-- Begin article item -->
<item>
<!-- REQUIRED: Unique article identifier -->
<guid isPermaLink="false">477648</guid>
<!-- REQUIRED: Headline/title of the article -->
<title><![CDATA[High-definition video encoding and streaming]]></title>
<!-- REQUIRED: Publication date -->
<pubDate>2017-10-04T08:00:00-05:00</pubDate>
<!-- OPTIONAL: Last modified date -->
<dcterms:modified>2017-10-10T10:00:00+0100</dcterms:modified>
<!-- REQUIRED: URL to full article -->
<link>https://v3spec.msn.com/articleid=2836489202/</link>
<!-- OPTIONAL: Author name -->
<dc:creator>Joe Gargery</dc:creator>
<!-- OPTIONAL: Subtitle -->
<dcterms:alternative>Article subtitle</dcterms:alternative>
<!-- OPTIONAL: Article validity window -->
<dcterms:valid>start=2016-10-01T10:00:00+0100; end=2018-10-02T10:00:00+0100; scheme=W3C-DTF</dcterms:valid>
<!-- OPTIONAL: Expiration date -->
<mi:expirationDate>2018-10-02T13:00:00.52Z</mi:expirationDate>
<!-- OPTIONAL: Short title for UI (<= 40 characters) -->
<mi:shortTitle>Short Title</mi:shortTitle>
<!-- OPTIONAL: Comma-separated keywords -->
<media:keywords>keyword1,keyword2,keyword3</media:keywords>
<!-- OPTIONAL: Categories -->
<category>News</category>
<category>Sports</category>
<!-- OPTIONAL: Summary (no HTML allowed) -->
<description><![CDATA[ Article description should be plain text, no HTML is allowed ]]></description>
<!-- REQUIRED: Full HTML article content -->
<content:encoded><![CDATA[
<img src="https://v3spec.msn.com/_files/assets/azure1.jpg" alt="Image title here." />
<p>Media Services enables you to encode your media files...</p>
<p>Here is an example of an embedded 1PP video:</p>
<video id="8172818" poster="https://v3spec.msn.com/videothumbnail.jpg">
<source src="https://v3spec.msn.com/video.mp4" type="video/mp4" />
</video>
<p>Example of embedded YouTube video:</p>
<iframe src="https://www.youtube.com/embed/XnZ_J3l_0z4?rel=0"></iframe>
<p>Example of inline slideshow:</p>
<div class="slideshow">
<figure>
<img src="https://v3spec.msn.com/image1.jpg" />
<figcaption>slide 1 caption</figcaption>
</figure>
</div>
]]></content:encoded>
<!-- REQUIRED: Main article image -->
<media:content url="https://v3spec.msn.com/image1.jpg" type="image/jpeg" medium="image">
<!-- OPTIONAL: Image credit -->
<media:credit>Joe Gargery/Fabrikam Images</media:credit>
<!-- OPTIONAL: Image title -->
<media:title>Image title</media:title>
<!-- OPTIONAL: Image alt text -->
<media:text>Image alt-text</media:text>
<!-- OPTIONAL: Focal crop region -->
<mi:focalRegion>
<mi:x1>120</mi:x1><mi:y1>120</mi:y1><mi:x2>400</mi:x2><mi:y2>400</mi:y2>
</mi:focalRegion>
<!-- OPTIONAL: Licensing metadata -->
<mi:hasSyndicationRights>1</mi:hasSyndicationRights>
<mi:licenseId>698525</mi:licenseId>
<mi:licensorName>Licensor name</mi:licensorName>
</media:content>
<!-- OPTIONAL: 3rd party video metadata -->
<media:content url="https://v3spec.msn.com/video.mp4" duration="91" type="video/mp4" medium="video">
<!-- REQUIRED inside video metadata -->
<guid>218736</guid>
<media:thumbnail url="https://v3spec.msn.com/image.jpg" />
<media:title>Video title</media:title>
<media:description>Video description</media:description>
<media:credit>Joe Gargery/Fabrikam Videos</media:credit>
<media:subTitle type="application/ttml" lang="en" href="https://www.contols.org/closedcaptions.ttml" />
</media:content>
<!-- OPTIONAL: Inline slideshow -->
<media:group>
<media:title>Slideshow title</media:title>
<media:credit role="author">Slideshow author</media:credit>
<media:content url="https://v3spec.msn.com/image1.jpg" type="image/jpeg" medium="image">
<media:credit>Joe Gargery/Fabrikam Images</media:credit>
<media:title>Slide 1 title</media:title>
<media:text>Slide 1 alt-text</media:text>
<media:description><![CDATA[<p>Slide 1 description</p>]]></media:description>
</media:content>
<media:content url="https://v3spec.msn.com/image2.jpg" type="image/jpeg" medium="image">
<media:credit>Joe Gargery/Fabrikam Images</media:credit>
<media:title>Slide 2 title</media:title>
<media:text>Slide 2 alt-text</media:text>
<media:description>Slide 2 description</media:description>
</media:content>
</media:group>
<!-- OPTIONAL: Related links with thumbnails -->
<atom:link rel="related" type="text/html" href="https://v3spec.msn.com/news/prop_irs_1.html" title="New IRS proposal">
<media:thumbnail url="https://v3spec.msn.com/related_link_thumbnail1.jpg" />
</atom:link>
<atom:link rel="related" type="text/html" href="https://v3spec.msn.com/news/prop_irs_2.html" title="New IRS proposal">
<media:thumbnail url="https://v3spec.msn.com/related_link_thumbnail2.jpg" />
</atom:link>
</item>
</channel>
</rss>
<?xml version="1.0" encoding="utf-8"?>
<rss xmlns:atom="http://www.w3.org/2005/Atom"
xmlns:media="http://search.yahoo.com/mrss/"
xmlns:mi="http://schemas.ingestion.microsoft.com/common/"
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:content="http://purl.org/rss/1.0/modules/content/"
xmlns:dcterms="http://purl.org/dc/terms/"
version="2.0">
<channel>
<title>Lifestyle</title>
<description>channel description</description>
<language>en-us</language>
<link>https://v3spec.msn.com/lifestyle</link>
<!-- BEGIN ARTICLE ITEM -->
<item>
<!-- Required Metadata -->
<guid isPermaLink="false">477648</guid>
<title><![CDATA[High-definition video encoding and streaming]]></title>
<pubDate>2017-10-04T08:00:00-05:00</pubDate>
<dcterms:modified>2017-10-10T10:00:00+0100</dcterms:modified>
<link>https://v3spec.msn.com/articleid=2836489202/</link>
<!-- Author and Metadata -->
<dc:creator>Joe Gargery</dc:creator>
<dcterms:alternative>Article subtitle</dcterms:alternative>
<dcterms:valid>start=2016-10-01T10:00:00+0100; end=2018-10-02T10:00:00+0100; scheme=W3C-DTF</dcterms:valid>
<mi:expirationDate>2018-10-02T13:00:00.52Z</mi:expirationDate>
<mi:shortTitle>Short Title</mi:shortTitle>
<media:keywords>keyword1,keyword2,keyword3</media:keywords>
<!-- Categories and Summary -->
<category>News</category>
<category>Sports</category>
<description><![CDATA[ Article description should be plain text, no HTML is allowed ]]></description>
<!-- Article Body (HTML) -->
<content:encoded><![CDATA[
<img src="https://v3spec.msn.com/_files/assets/azure1.jpg"
alt="Image title here."
title="Image title"
data-portal-copyright="Joe Gargery/Fabrikam Images"
data-has-syndication-rights="1"
data-license-id="698526"
data-licensor-name="Licensor name"
data-focal-region="x1:246,y1:140,x2:246,y2:140" />
<p>Media Services enables you to encode your media files...</p>
<p>Here is an example of an embedded 1PP video:</p>
<video id="8172818"
title="an inline video"
poster="https://v3spec.msn.com/videothumbnail.jpg"
data-description="this is a sample inline video"
data-portal-copyright="Joe Gargery/Fabrikam Videos">
<source src="https://v3spec.msn.com/video.mp4" type="video/mp4" />
</video>
<p>Example of embedded YouTube video:</p>
<iframe src="https://www.youtube.com/embed/XnZ_J3l_0z4?rel=0" frameborder="0" allowfullscreen></iframe>
<p>Example of inline slideshow:</p>
<div class="slideshow">
<cite>Slideshow author</cite>
<title>Slideshow title</title>
<figure>
<img src="https://v3spec.msn.com/image1.jpg" title="slide 1 title" />
<figcaption>slide 1 caption <span class="copyright">slide 1 copyrights</span></figcaption>
</figure>
<figure>
<img src="https://v3spec.msn.com/image2.jpg" title="slide 2 title" />
<figcaption>slide 2 caption <span class="copyright">Joe Gargery/Fabrikam Images</span></figcaption>
</figure>
</div>
]]></content:encoded>
<!-- Featured Image Metadata -->
<media:content url="https://v3spec.msn.com/image1.jpg" type="image/jpeg" medium="image">
<media:credit>Joe Gargery/Fabrikam Images</media:credit>
<media:title>Image title</media:title>
<media:text>Image alt-text</media:text>
<mi:focalRegion>
<mi:x1>120</mi:x1><mi:y1>120</mi:y1><mi:x2>400</mi:x2><mi:y2>400</mi:y2>
</mi:focalRegion>
<mi:hasSyndicationRights>1</mi:hasSyndicationRights>
<mi:licenseId>698525</mi:licenseId>
<mi:licensorName>Licensor name</mi:licensorName>
</media:content>
<!-- Video Metadata (3PP) -->
<media:content url="https://v3spec.msn.com/video.mp4" duration="91" type="video/mp4" medium="video">
<guid>218736</guid>
<media:thumbnail url="https://v3spec.msn.com/image.jpg" />
<media:title>Video title</media:title>
<media:description>Video description</media:description>
<media:credit>Joe Gargery/Fabrikam Videos</media:credit>
<media:subTitle type="application/ttml" lang="en" href="https://www.contols.org/closedcaptions.ttml" />
</media:content>
<!-- Inline Slideshow -->
<media:group>
<media:title>Slideshow title</media:title>
<media:credit role="author">Slideshow author</media:credit>
<media:content url="https://v3spec.msn.com/image1.jpg" type="image/jpeg" medium="image">
<media:credit>Joe Gargery/Fabrikam Images</media:credit>
<media:title>Slide 1 title</media:title>
<media:text>Slide 1 alt-text</media:text>
<media:description><![CDATA[<p>Slide 1 description</p>]]></media:description>
</media:content>
<media:content url="https://v3spec.msn.com/image2.jpg" type="image/jpeg" medium="image">
<media:credit>Joe Gargery/Fabrikam Images</media:credit>
<media:title>Slide 2 title</media:title>
<media:text>Slide 2 alt-text</media:text>
<media:description>Slide 2 description</media:description>
</media:content>
</media:group>
<!-- Related Links -->
<atom:link rel="related" type="text/html" href="https://v3spec.msn.com/news/prop_irs_1.html" title="New IRS proposal">
<media:thumbnail url="https://v3spec.msn.com/related_link_thumbnail1.jpg" />
</atom:link>
<atom:link rel="related" type="text/html" href="https://v3spec.msn.com/news/prop_irs_2.html" title="New IRS proposal">
<media:thumbnail url="https://v3spec.msn.com/related_link_thumbnail2.jpg" />
</atom:link>
</item>
<!-- END ARTICLE ITEM -->
</channel>
</rss>
Notes
-
Use media:content for each slide image.
-
Always include a guid, title, and pubDate for each item.
-
The media:title and media:description should match what you'd show in a visual slideshow viewer.
-
Be sure to wrap any rich text in <![CDATA[]]>.
-
Use atom:link with media:thumbnail for related article links.
RSS audio feed example
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
xmlns:media="https://search.yahoo.com/mrss/"
xmlns:mi="https://schemas.ingestion.microsoft.com/common/"
xmlns:dc="https://purl.org/dc/elements/1.1/"
xmlns:content="https://purl.org/rss/1.0/modules/content/"
xmlns:dcterms="https://purl.org/dc/terms/"
xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd">
<channel>
<!-- Channel Metadata -->
<title>Feed title</title>
<link>https://www.contoso.com/sports</link>
<description>Feed description</description>
<lastBuildDate>01 Oct 2017 13:00:00 GMT</lastBuildDate>
<!-- Example 1: Audio using Media RSS -->
<item>
<guid isPermaLink="false">723435</guid>
<title>Example audio using Media RSS</title>
<pubDate>01 Oct 2018 13:00:00 GMT</pubDate>
<dcterms:modified>2018-10-10T10:00:00+0100</dcterms:modified>
<link>https://v3spec.msn.com/audioid=2836489202/</link>
<dcterms:valid>start=2016-10-01T10:00:00+0100; end=2018-10-02T10:00:00+0100; scheme=W3C-DTF</dcterms:valid>
<description>Audio description</description>
<media:content url="https://contoso.com/audio/sample.mp3"
duration="512"
type="audio/mpeg"
medium="audio">
<media:thumbnail url="https://v3spec.msn.com/image.jpg"
height="480"
width="853" />
<media:title>Example audio using Media RSS</media:title>
<media:description>Audio description</media:description>
<media:credit>Joe Gargery/Fabrikam Videos</media:credit>
</media:content>
</item>
<!-- Example 2: Audio using iTunes Namespace -->
<item>
<guid isPermaLink="false">723435</guid>
<title>Example audio using iTunes namespace</title>
<pubDate>01 Oct 2018 13:00:00 GMT</pubDate>
<link>https://v3spec.msn.com/audioid=2836489202/</link>
<dcterms:modified>2018-10-10T10:00:00+0100</dcterms:modified>
<dcterms:valid>start=2016-10-01T10:00:00+0100; end=2018-10-02T10:00:00+0100; scheme=W3C-DTF</dcterms:valid>
<description>Audio description</description>
<itunes:title>Audio stream title</itunes:title>
<itunes:author>Provider name</itunes:author>
<itunes:subtitle>Audio stream subtitle</itunes:subtitle>
<itunes:summary><![CDATA[audio stream description]]></itunes:summary>
<itunes:duration>110</itunes:duration>
<enclosure url="https://contoso.com/audio/sample.mp3"
type="audio/mpeg" />
</item>
</channel>
</rss>
Key notes
Section |
Description |
---|---|
<media:content> |
Use for Media RSS format. Supports thumbnails, credit, and metadata. |
<itunes:*> |
Use for podcast-style feeds. Includes author, summary, and duration. |
<enclosure> |
Required for iTunes feeds. Points to the actual MP3 stream. |
guid |
Must be unique per item; do not reuse. |
pubDate |
Required. Use RFC 822 or RFC 3339 format. |
dcterms:valid |
Controls custom expiration (optional). |
RSS video feed example
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
xmlns:atom="http://www.w3.org/2005/Atom"
xmlns:media="http://search.yahoo.com/mrss/"
xmlns:mi="http://schemas.ingestion.microsoft.com/common/"
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:dcterms="http://purl.org/dc/terms/">
<channel>
<!-- Channel Metadata -->
<title>Feed title</title>
<link>https://www.contoso.com/sports</link>
<description>Feed description</description>
<lastBuildDate>01 Oct 2017 13:00:00 GMT</lastBuildDate>
<!-- Video Item -->
<item>
<!-- Required Metadata -->
<guid isPermaLink="false">723435</guid>
<title>Video title</title>
<pubDate>01 Oct 2017 13:00:00 GMT</pubDate>
<dcterms:modified>2017-10-10T10:00:00+0100</dcterms:modified>
<link>https://v3spec.msn.com/articleid=2836489202/</link>
<!-- Author & Subtitle -->
<dc:creator>Video author</dc:creator>
<dcterms:alternative>Article subtitle</dcterms:alternative>
<!-- Expiration Controls -->
<dcterms:valid>
start=2016-10-01T10:00:00+0100;
end=2018-10-02T10:00:00+0100;
scheme=W3C-DTF
</dcterms:valid>
<mi:expirationDate>2018-10-02T13:00:00.52Z</mi:expirationDate>
<!-- Description & Metadata -->
<description>Video description</description>
<media:keywords>keyword1,keyword2,keyword3</media:keywords>
<category>News</category>
<category>Sports</category>
<!-- Video Metadata -->
<media:content
url="https://v3spec.msn.com/video.mp4"
duration="512"
type="video/mp4"
medium="video">
<!-- Thumbnail -->
<media:thumbnail
url="https://v3spec.msn.com/image.jpg"
height="480"
width="853" />
<!-- Title & Description (Overrides) -->
<media:title>Video title</media:title>
<media:description>Video description</media:description>
<!-- Attribution -->
<media:credit>Joe Gargery/Fabrikam Videos</media:credit>
<!-- Captions (TTML format) -->
<media:subTitle
type="application/ttml"
lang="en"
href="https://www.contols.org/closedcaptions.ttml" />
</media:content>
</item>
</channel>
</rss>
Key notes
Section |
Purpose |
---|---|
<guid> |
Uniquely identifies the video item. |
<media:content> |
Embeds metadata about the actual video file (URL, type, duration, etc.) |
<media:subTitle> |
Points to optional TTML file for closed captions. |
<media:title/description> |
Overrides the item-level title/description when specified. |
<mi:expirationDate> |
Optional override for default 1-year item lifespan. |
dcterms:valid |
Also supports time-bound availability windows. |
Takedown request example (RSS item format)
<!-- Example of a takedown request.
You must provide a <guid> of an existing item,
a modified date, and an expiration date in the past. -->
<item>
<!-- REQUIRED: Unique identifier of the content to be removed.
This ID must reference an already ingested document. -->
<guid isPermaLink="false">477649</guid>
<!-- REQUIRED: Use <dcterms:modified> to signal that this is a new update. -->
<dcterms:modified>2017-10-10T10:00:00+0100</dcterms:modified>
<!-- REQUIRED: Use <dcterms:valid> to specify an end date in the past.
This will trigger the takedown of the associated content. -->
<dcterms:valid>end=1990-10-02T10:00:00+0100; scheme=W3C-DTF</dcterms:valid>
</item>
Notes
-
The <guid> must match an item already present in your ingestion history.
-
The <dcterms:modified> element is required to register this as an update.
-
The <dcterms:valid> element must include an end date in the past to remove the item from visibility.