Main Page

Format ESS

.ess, .xml
application/ess+xml
version 0.9

ESS: A XML Standard - ESS is The Events Feed

ESS stands for Event Standard Syndication.

• ESS standard is free and open-source XML feed invented exclusively for events.
• ESS Feeds can be published from add-ons in most CMS or with simple code libraries.
• ESS federates provider’s events into one feed that can be updated everywhere in real-time.

Until now, event promoters could only use RSS or iCalendar to broadcast their events.
The problem has been that vital information gets lost in the event description.

Event Portal	RSS Feed
Web readers	Robots...

Now, with ESS all the criteria of any events are clearly defined.

Event Portal	ESS Feed
Web readers	Robots!

ESS increases traffic for publishers.

ESS Libraries

ESS Feeds can be generated from open-source libraries published on: https://github.com/essfeed
You can also help the web community to create or improve these open-source libraries.

1. Select an open source library and download the code in your web language.
2. Place the few lines of code where you generate events.
3. Each generated event is automatically submitted to the list of event aggregators defined in the library.

	ESS Library available for PHP ESS Library available for JAVA ESS Library available for JavaScript ESS Library available for AS3 ESS Library available for Ruby On Rail ESS Library available for Python

ESS Structure

DTD description available http://essfeed.org/history/0.9

ESS Documents are formatted in XML. ESS document are structurized with two types of XML elements :

• Simple XML elements without children to define "title", "publishing date"...
• And 8 "main XML element" that precisely describes the event.

 version="1.0" encoding="UTF-8"?>

 xmlns="http ://essfeed.org/history/0.9" version="0.9" lang="en">
  
     National Football Stadium events
     http://sample.com/feeds/sample.ess
     ESSID:50b4b412-1ad4-a731-1c6a-2523ffa33f81
     2011-12-13T08:29:29Z
     2011-12-13T18:30:02Z
     ess:php:generator:version:0.91
     Copyright (c) 2012, John Doe
     
     
         Saturday Football Match
         EVENTID:550b55b412-1ad4-a4731-155-2777fa37f866
         http://sample.com/events/specific-and-unique-event-page/
         2012-12-13T08:29:29Z
         2012-12-13T18:30:02Z
         PUBLIC
         
         
             Sport
             Football
             Soccer
         

             
                 
                  
                 
                 
                  
              
         
      
 
      ...
      ...
      
  

ESS Examples

The best way to understand how a standard or a protocol works is to see a complete example in a common situation. Here is a football match event. A feed can be shorter, but this event displays the majority of the tags and features available in the ESS standard.

sample.ess | See the .ess file source by clicking at the end Expand/Collapse

 version="1.0" encoding="UTF-8"?>

 xmlns="http://essfeed.org/history/0.9" version="0.9" lang="en">
   >        
      National Stadium Football events>
      >http://sample.com/feeds/sample.ess>
      >ESSID:50b4b412-1ad4-a731-1c6a-2523ffa33f81>
      >2012-12-13T08:29:29Z>
      >2012-12-13T18:30:02-08:00>
      >ess:php:generator:version:0.9>
      >Copyright (c) 2013, John Doe>
 
      >
          Football match of saturday>
          >EVENTID:550b55b412-1ad4-a4731-155-2777fa37f866>
          >http://sample.com/events/specific-and-unique-event-page/>
          >2012-12-13T08:29:29Z>
          >2012-12-13T18:30:02-0800>
          >PUBLIC>
          >
              
                 Welcome to my first football match event.
                 This football match is very important.
                 Our team is about to go up against our main league competitor.
              ]]>
          >
          >
              >Sport>
              >Football>
              >Soccer>
              >Match>
              >Game>
              >Team Sport>
              >Stadium>
          >
 

         >
             type="competition">
               >Football>
               >C2AH>
            >
         >
 

          >
              type="recurrent" unit="week" limit="4" selected_day="saturday,sunday">
                >Match Date> 
                >2011-12-13T18:30:02Z>
                >10800>
             >
          >
 

          >
              type="fixed" priority="1">
                >Football Stade>   
                >40.71675>
                >-74.00674>
                
>Ave of Americas, 871>
                >New York>
                >10001>
                >NY>
                >US>
             >
              type="virtual" priority="2">
                >Match direct on TV>
                >US>
                >NBC super channel>
                >television>
             >
         >
 

          >
              type="standalone" mode="invitation" priority="2">
                >Free entrance>
                >0>
                >USD>
             >
              type="recurrent" unit="month" mode="fixed" limit="12" priority="1">
                >Subscribe monthly !>
                >17>
                >USD>
                >2012-12-13T18:30:02Z>
             >
          >
 

          >
              type="image" priority="1"> 
                >Stade image>
                >http://sample.com/small/image_1.png>
             >
              type="video" priority="3"> 
                >Stade video>
                >http://sample.com/video/movie.mp4> 
             >
              type="sound" priority="2">
                >Radio spot>
                >http://sample.com/video/movie.mp3>
             >
              type="website" priority="4">
                >Football Stade website>
                >http://my-football-website.com>
             >
          >
 

          >
              type="organizer">
                >THJP167:8URYRT24:BUEREBK:567TYEFGU:IPAAF>
                >http://michaeldoe.com>
                >Michael Doe>
                >Michael>
                >Doe>
                >Football club association>
                
>80, 5th avenue / 45st E - #504>
                >New York>
                >10001>
                >New York>
                >NY>
                >United States of America>
                >US>
                >http://sample.com/logo_120x60.png>
                >http://sample.com/icon_64x64.png>
                >[email protected]>
                >+001 (646) 234-5566>
             >
              type="performer">
                >FDH56:G497D6:4564DD465:4F6S4S6>
                >http://janettedoe.com>
                >Janette Doe>
             >
              type="attendee">
                >Attendees information:>
                >0>
                >500>
                >0>
                >Smoking is not allowed in the stadium>
             >
              type="social">
                >Social network link to share or rate the event.>
                >http://social_network.com/my_events/my_friends/my_notes>
             >
              type="author">
                >Feed Powered by Event Promotion Tool>
                >http://sample.com/my_events/>
                >http://sample.com/logo_120x60.png>
                >http://sample.com/icon_64x64.png>
            >
             type="contributor">
                >Paul Doe>
            >
          >
 

          >
              type="alternative">
                >alternative event>
                >EVENTID:50412:1a904:a715731:1cera:25va33>
                >http://sample.com/feed/event_2.ess>
             >
              type="related">
                >related event title>
                >EVENTID:50b412:1a35d4:a731:1354c6a:225dg1>
                >http://sample.com/feed/event_3.ess>
             >
              type="enclosure">
                >nearby event>
                >EVENTID:50b12:3451d4:34f5a71:1cf6a:2ff81>
                >http://sample.com/feed/event_5.ess>
             >
          >
 
       >
 
   >
>

next >

External documentation

ESS standard under RFC validation process: RFC ESS Draft

• RFC 3023 : XML Media Types
• RFC 3066 : Tags for the Identification of Languages
• RFC 3076 : Canonical XML Version 1.0
• RFC 4287 : The Atom Syndication Format