CINXE.COM

<!doctype html> <html lang="en"> <head> <title>IndieNews - How to submit a post</title> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"> <meta name="description" content="IndieNews"> <link rel="webmention" href="https://news.indieweb.org/en/webmention" />  <meta name="viewport" content="width=device-width, initial-scale=1.0"> <link rel="stylesheet" href="/bootstrap/css/bootstrap.min.css"> <link rel="stylesheet" href="/bootstrap/css/bootstrap-responsive.min.css"> <link rel="stylesheet" href="/css/style.css"> <script src="/js/jquery-1.7.1.min.js"></script> <script src="/js/jquery.timeago.js"></script> <script src="/js/timeago/jquery.timeago.en.js"></script> </head> <body> <div class="navbar navbar-static-top"> <div class="navbar-inner"> <a class="brand" href="/">IndieNews</a> <ul class="nav"> <li><a href="/en">Home</a></li> <li><a href="/en/submit">Submit</a></li> <li><a href="/en/members">Members</a></li> </ul> </div> </div> <div class="page"> <div class="hero-unit" style="padding: 40px;"> <h2>IndieNews</h2> <p>IndieNews is a community-curated list of articles relevant to the <a href="https://indieweb.org/why">Indie Web</a>.</p> </div> <div class="row"> <div class="span8"> <h2>How to Submit a Post to IndieNews</h2> <p>In order to submit a post, you do not need an IndieNews account. Instead, you can only submit posts from your own site by linking to the IndieNews site and sending a notification using the <a href="https://indieweb.org/webmention">webmention</a> protocol!</p> <h3>1. Write a post on your own site</h3> <p>Create a new post on your site, and mark it up with the Microformats markup for an <a href="http://microformats.org/wiki/microformats2#h-entry">h-entry</a>.</p> <p>If you are submitting your own post, that's all you have to do.</p> <p>To submit someone else's post, you can post a bookmark on your site and submit that URL to IndieNews! Post an h-entry as normal, then include a <a href="https://indieweb.org/bookmark#How">u-bookmark-of</a> property linking to the actual URL you want to submit.</p> <h3>2. Add a "u-syndication" or "u-category" link to IndieNews</h3> <p>Inside the h-entry, add a link to the IndieNews home page for your language with the class <a href="https://indieweb.org/rel-syndication">u-syndication</a> or <a href="https://indieweb.org/u-category">u-category</a>. This usually looks something like the following:</p> <p><pre><code><a href="https://news.indieweb.org/en" class="u-syndication"> Also posted on IndieNews </a></code></pre></p> <p><pre><code><a href="https://news.indieweb.org/en" class="u-category">#indienews</a></code></pre></p> <h3>3. Send a <a href="https://indieweb.org/webmention">Webmention</a></h3> <p>If your website sends <a href="https://www.w3.org/TR/webmention/">Webmentions</a> automatically, then you don't need to worry about this step. Otherwise, follow the instructions below to send a Webmention, or just use the Webmention form available at <a href="/en/webmention">the IndieNews Webmention endpoint</a>.</p> <h4>Example Request</h4> <p>Make a POST request to <code>https://news.indieweb.org/en/webmention</code> with two parameters, <code>source</code> and <code>target</code>, where target is <code>https://news.indieweb.org/en</code> and source is <code>http://example.com/100</code> assuming you are submitting a page on your site with the url <code>http://example.com/100</code>.</p> <p>Note that each language's home page has a unique Webmention endpoint, so you should do the Webmention endpoint discovery as normal to find it.</p> <pre><code>POST /en/webmention HTTP/1.1 Host: news.indieweb.org target=https://news.indieweb.org/en &source=https://aaronparecki.com/2013/04/25/4/original-post-discovery </code></pre> <h4>Example Response</h4> <pre><code>HTTP/1.1 201 Created Location: https://news.indieweb.org/en/aaronparecki.com/2013/04/25/4/original-post-discovery { "result": "success", "notices": [ ], "data": { "title": "A demonstration of Original Post Discovery #indieweb", "author": "aaronparecki.com", "date": "2013-04-26T03:22:39+00:00" }, "source": "https://aaronparecki.com/2013/04/25/4/original-post-discovery", "url": "https://news.indieweb.org/en/aaronparecki.com/2013/04/25/4/original-post-discovery" } </code></pre> <p>You can find the permalink of your syndication by looking for the <code>Location</code> header in the response. You can then update your post with that URL so that your post always links to the IndieNews permalink instead of the IndieNews home page.</p> <p>This webmention endpoint also returns more data that is useful for debugging purposes while you're initially trying it out.</p> <ul> <li><code>result</code> - Will be equal to "success" if the submission was accepted</li> <li><code>notices</code> - An array of string messages if there was anything that needs attention in your submission. These are not errors, but will indicate if microformat markup was not present or invalid.</li> <li><code>data</code> - This object shows the values extracted from the page, including title, author and date.</li> <li><code>source</code> - The source URL sent in the initial request</li> <li><code>url</code> - The permalink to this submission on news.indieweb.org.</li> </ul> <h4>Sample Code</h4> <h5>Curl</h5> <pre><code>curl https://news.indieweb.org/en/webmention -i \ -d target=https://news.indieweb.org/en \ -d source=https://aaronparecki.com/2013/04/25/4/original-post-discovery </code></pre> <h5>PHP</h5> <pre><code><?php $ch = curl_init("https://news.indieweb.org/en/webmention"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, array( 'target' => 'https://news.indieweb.org/en', 'source' => 'https://aaronparecki.com/2013/04/25/4/original-post-discovery' )); echo curl_exec($ch); ?></code></pre> <h5>Ruby</h5> <pre><code>require 'rest-client' require 'json' data = JSON.parse RestClient.post "https://news.indieweb.org/en/webmention", { 'target' => 'https://news.indieweb.org/en', 'source' => 'https://aaronparecki.com/2013/04/25/4/original-post-discovery' } jj data </code></pre> <h4>Re-Submitting a Post</h4> <p>If you update the post (for example trying to debug the microformats markup, or changing the post title), you can re-send the webmention. The existing IndieNews post will be updated with the new information found.</p> <h3>Microformats Support</h3> <p>Your page must be marked up with an <a href="https://microformats.org/wiki/microformats2#h-entry">h-entry</a> or an <a href="https://microformats.org/wiki/microformats2#h-event">h-event</a>, IndieNews will use the name in the entry as the title of the submission.</p> <p>If an <a href="http://microformats.org/wiki/microformats-2#h-card">h-card</a> is present, author information will be pulled from there, otherwise it will fall back to using the domain name as the author.</p> <h3>Pingback Support</h3> <p>If you use a client which automatically sends <a href="https://indieweb.org/pingback">pingbacks</a> to any links found in the post, then you can use the same flow as the WebMention flow but send a Pingback instead! You can find the pingback endpoint using the normal pingback discovery mechanism.</p> <p>Note that the rich debugging response will not be present in the pingback reply.</p> </div> </div> <div class="footer"> <ul class="nav-footer"> <li><a href="/en/submit">About IndieNews</a></li> <li><a href="/how-to-submit-a-post">How to Submit a Post</a></li> </ul> <p class="credits">© 2025 by <a href="http://aaronparecki.com">Aaron Parecki</a>. IndieNews is part of <a href="https://indieweb.org/">IndieWebCamp</a>. This code is <a href="https://github.com/aaronpk/IndieNews">open source</a>. Feel free to send a pull request, or <a href="https://github.com/aaronpk/IndieNews/issues">file an issue</a>.</p> </div> </div> <script> jQuery(function($){ $("time.timeago").timeago(); }); </script> </body> </html>