HOME

RSS Basic
RSS Home
RSS Introduction
RSS History
RSS Syntax
RSS <channel>
RSS <item>
RSS Publish Feed
RSS Read a Feed

References
RSS Reference

Selected Reading
Web Statistics
Web Glossary
Web Hosting
Web Quality

W3Schools Forum

Helping W3Schools

RSS <item> Element

Each <item> element defines an article or "story" in the RSS feed.

The <item> Element

Look at the following RSS document:

<?xml version="1.0" encoding="ISO-8859-1" ?>
<rss version="2.0">

<channel>
  <title>W3Schools Home Page</title>
  <link>http://www.w3schools.com</link>
  <description>Free web building tutorials</description>
  <item>
    <title>RSS Tutorial</title>
    <link>http://www.w3schools.com/rss</link>
    <description>New RSS tutorial on W3Schools</description>
  </item>
</channel>

</rss>

As mentioned before, each <item> element defines an article or "story" in the RSS feed.

The <item> element has three required child elements:

<title> - Defines the title of the item (e.g. RSS Tutorial)
<link> - Defines the hyperlink to the item (e.g. http://www.w3schools.com/rss)
<description> - Describes the item (e.g. New RSS tutorial on W3Schools)

Furthermore, there are several optional child elements of <item>. We will explain the most important ones below.

The <author> Element

The <author> child element is used to specify the e-mail address of the author of an item.

Note: To prevent spam e-mails, some developers do not include the <author> element.

The author of the item in the RSS document above could be:

<author>hege@refsnesdata.no</author>

The <comments> Element

The <comments> child element allows an item to link to comments about that item.

A comment of the item in the RSS document above could be:

<comments>http://www.w3schools.com/comments</comments>

The <enclosure> Element

The <enclosure> child element allows a media-file to be included with an item.

The <enclosure> element has three required attributes:

url - Defines the URL to the media file
length - Defines the length (in bytes) of the media file
type - Defines the type of media file

A media-file included in the item in the RSS document above could be:

<enclosure url="http://www.w3schools.com/rss/rss.mp3
length="5000" type="audio/mpeg" />

RSS <item> Reference

Element	Description
<author>	Optional. Specifies the e-mail address to the author of the item
<category>	Optional. Defines one or more categories the item belongs to
<comments>	Optional. Allows an item to link to comments about that item
<description>	Required. Describes the item
<enclosure>	Optional. Allows a media file to be included with the item
<guid>	Optional. Defines a unique identifier for the item
<link>	Required. Defines the hyperlink to the item
<pubDate>	Optional. Defines the last-publication date for the item
<source>	Optional. Specifies a third-party source for the item
<title>	Required. Defines the title of the item

Jump to: Top of Page or HOME or Printer friendly page

W3Schools provides material for training only. We do not warrant the correctness of its contents. The risk from using it lies entirely with the user. While using this site, you agree to have read and accepted our terms of use and privacy policy.

W3Schools was converted to XHTML in December 1999