Tela
Join

For writers

How Tela reads your blog

Tela is a feed reader. It reads the RSS, Atom or JSON feed your blog already publishes, as any feed reader does, and asks your server for as little as it can.

  • It says who it is

    Every request carries Tela’s user agent, Tela/0.1 (+https://telaread.com; feed reader), or for images Tela/0.1 (+https://telaread.com; image proxy). Each is also signed with Tela’s key (Web Bot Auth), so your server or your CDN can tell it really is Tela; the key is published at https://telaread.com/.well-known/http-message-signatures-directory.

  • About as often as you post

    Tela checks your feed about twice as often as you published over the past week: every 30 minutes at most, and at least once a day. Each check that finds nothing new waits a little longer for the next. Your feed’s ttl and Cache-Control: max-age can ask it to wait longer, up to a day.

  • Only what changed

    Each check sends back the ETag and Last-Modified your server gave, so a feed that hasn’t changed costs a 304 and nothing more.

  • It backs off

    When your server fails or doesn’t answer, Tela waits twice as long after each failure, up to a week, and at least as long as a Retry-After asks. After a 410 Gone, or 30 failures in a row, it tries once a week.

  • Images when someone reads

    The images in your posts are fetched only when someone reads the post, through Tela’s image proxy, and then kept for a week.

  • Your pages, only when the feed is short

    If your feed carries only summaries, Tela fetches each new post’s public page once, soon after the feed lists it, to show the full text to subscribers in the reader, and again only if the summary changes. It reads your home page once, when your blog is added, to find its icon. Both ask your robots.txt first.

To verify a claim, Tela reads your home page and, for a link without rel="me", one address your blog doesn’t have, to see its 404 page.

As with any crawler, rules addressed to Tela replace the ones for every crawler (User-agent: *). Your feed is still read, as every feed reader reads it: a subscriber asked for it.

What Tela shows

  • In public, titles and excerpts

    Tela’s public pages, the ones anyone and any search engine can open, show your posts’ titles and short excerpts, each linking to the post on your blog. They never show a post in full.

  • To subscribers, your posts in full

    Members who subscribe to your blog read your posts in full, in Tela’s reader and in the apps Tela approves, from your feed or the post’s page, as in any feed reader. Other members can open a limited number of posts a day from blogs they don’t subscribe to, and visitors see only excerpts. If you turn translation off, Tela stops translating your blog and stops sending its translations to readers and apps.

  • Translations, labelled

    Titles and excerpts are translated ahead of time into Tela’s reading languages, so readers can find your posts. A post itself is translated only for a reader who asks for it. Every translation is a machine’s, labelled as one and shown beside your original, and you can turn translation off for your blog.

Your blog stays yours

  • Nothing moves

    Tela reads the feed you already publish, and every post links back to your blog.

  • No ads

    Tela shows no ads.

  • Translation is yours to turn off

    Readers can read your posts translated. If you would rather they didn’t, turn translation off from the Dashboard.