RSSFeeds.com

OPML: Outline Processor Markup Language

OPML is the file format RSS readers use to export and import subscriptions. It lets you take your feeds with you, share a reading list or publish a "blogroll" that others can subscribe to in one go.

Updated

Illustration of an outline tree of feed subscriptions

What OPML Is

OPML stands for Outline Processor Markup Language. Dave Winer created it around 2000 for the outliner in Radio UserLand, as a general format for nested outlines. Feed readers adopted it to exchange subscription lists, and that's almost the only place you'll meet it today. The current version, OPML 2.0, was published in 2006.

File extension.opml (sometimes .xml)
MIME typetext/x-opml is common; application/xml also works
Specificationopml.org/spec2.opml

A Subscription List in OPML

subscriptions.opml
<?xml version="1.0" encoding="UTF-8"?>
<opml version="2.0">
  <head>
    <title>My subscriptions</title>
    <dateCreated>Wed, 11 Nov 2026 09:00:00 +0000</dateCreated>
    <ownerName>Jane Doe</ownerName>
    <docs>http://opml.org/spec2.opml</docs>
  </head>
  <body>
    <outline text="Technology" title="Technology">
      <outline type="rss" text="Example Blog" title="Example Blog"
        xmlUrl="https://example.com/feed.xml" htmlUrl="https://example.com/" />
      <outline type="rss" text="Changelog" title="Changelog"
        xmlUrl="https://dev.example.com/changelog.atom" htmlUrl="https://dev.example.com/changelog" />
    </outline>
    <outline type="rss" text="Field Notes" xmlUrl="https://notes.example/feed.xml" />
  </body>
</opml>

The <head> holds metadata about the list. The <body> contains <outline> elements. An outline with xmlUrl is a feed; an outline with children is a folder. Most readers support one level of folders.

Outline Attributes for Feeds

AttributeDescription
textrequiredThe display name. Also used for folder names.
typerequired for feedsrss for any feed, including Atom and JSON Feed.
xmlUrlrequired for feedsThe feed URL. Note the capital U.
htmlUrloptionalThe website of the feed.
titleoptionalThe feed's own title. Many readers write the same value as text.
description, languageoptionalFrom the feed's channel.
versionoptionalFormat hint: RSS2, RSS1, RSS or scriptingNews.

Other outline types exist: link (with a url attribute) for a web page and include to include another OPML file by reference.

All optional: title, dateCreated and dateModified (RFC 822 dates), ownerName, ownerEmail, ownerId, docs, and outliner state elements such as expansionState, vertScrollState and window positions that feed readers ignore.

Exporting, Importing and Sharing

  1. Export from your current reader. The option is usually under settings, "Import/Export" or "Manage feeds".
  2. Clean up the file in the OPML Editor: remove dead feeds and duplicates, rename folders, merge exports from several readers.
  3. Import in the new reader. Folder structure and titles come along; read/unread state and starred items don't – OPML only lists subscriptions.

Publishing an OPML file on your site is a lovely way to share what you read. Some readers let you subscribe to a remote OPML file, so your followers automatically get feeds you add later.

Common OPML Problems

  • Unescaped ampersands in titles or URLs make the whole file unreadable. Every & in an attribute must be &amp;.
  • Lowercase xmlurl: attribute names are case-sensitive. Our editor accepts both, but not every reader does.
  • Nested folders deeper than one level are flattened by most readers.
  • Dead feeds pile up over years. Check them in bulk with the OPML Editor before moving.

Sources and Further Reading