Text of help.tumblr.com › knowledge-base › developer-resources as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout.

Open the live page

Developer Resources – Tumblr Help Center

Skip to content Developer Resources In this Guide 👋 Hello, developers! Here you’ll find a quick reference guide for all of our developer resources. Want to work with us? Check out our job openings . The Tumblr API Documentation The official Tumblr API docs can be found on GitHub and on Tumblr . If you’re looking for the old v1 API, you can find the documentation on our “Tumblr API v1 page “. Rate Limits The default rate limits are: 1,000 API calls per hour, per consumer key.

5,000 API calls per day, per consumer key. Additional rate limits can be found on GitHub . If you need to increase or remove the rate limits on your app, you can submit a request by going to tumblr.com/oauth/apps . Click “Request rate limit removal” under the relevant app (doing so will open an email to api_ratelimit@tumblr.com) Bug Reports and Feature Requests If you encounter a bug with the API, see an inconsistency in our documentation, or have a feature request, you can contact us through the following channels: Open a GitHub issue .

Create a ticket with our Support team . We ask that you do not use pull requests to propose changes. Share Your Work Have you used the Tumblr API to make something really neat? We’d love to see it! Share your project with us in a Support ticket , or share it in a post on Tumblr and tag it with “tumblr staff”. We check that tag pretty regularly. Custom Themes Your blog’s theme determines how your blog appears on the blog network.

The customization options here are (almost) limitless. You can learn how to customize your blog theme in our “ Customizing Your Theme ” article. Custom Theme Documentation Whether you want to make some slight adjustments to your current theme or build a brand new theme from scratch, you should become familiar with our theme engine. The full documentation for creating a custom blog theme can be found here . The Neue Post Format When developing or customizing a theme, keep in mind that Neue Post Format (NPF) posts do not have a legacy post type and are instead treated as legacy text posts in blog themes.

You can read the NFP specs on GitHub . For more information on how to make your theme compatible with NPF, check the “Neue Post Format” section in our custom theme documentation . Localizing Custom Themes We’ve provided a set localized theme strings so that folks using your theme can see it in their designated language. The full list can be found here . Submitting a Theme to the Theme Garden (tumblr.com/themes) Ready to share your theme with other Tumblr users?

You can submit it to be available on the Theme Garden ( tumblr.com/themes ) by going to tumblr.com/themes/new . You’ll find the full submission guidelines here . Please read them before submitting your theme! GitHub Integration for Custom Themes If you use GitHub to manage your Tumblr themes, you can configure your repository to push updates to Tumblr automatically. You’ll find instructions here . Premium Tumblr Themes If you have at least one free theme already available at tumblr.com/themes , you can start selling your themes.

Premium themes are priced at $9, $19, or $49, and developers keep the majority of that money. Interested? Send an email to themes@tumblr.com. Other Resources We’ve got all kinds of neat stuff over on our GitHub . We hope to continue to make more of Tumblr open source, so stay tuned. You can also check out: Our Engineering blog for deep dives into the work done by our Engineering teams. The Changes blog , for updates about ongoing development (including bug fixes).

Our bug bounty program . Share buttons to use on other sites. Official Tumblr logos to use in your project. Just be sure to follow the guidelines. Our article about how to embed a Tumblr post or blog . Is something missing from this page? See something that needs improving? Contact Support to let us know. In this Guide Not quite what you were looking for? Contact us Related articles Public record of usernames linked to state-sponsored disinformation campaigns Read this guide Read more : Public record of usernames linked to state-sponsored disinformation campaigns Getting More Traffic and Engagement Read this guide Read more : Getting More Traffic and Engagement Ireland Online Safety Code Read this guide Read more : Ireland Online Safety Code Australia Online Safety Act Read this guide Read more : Australia Online Safety Act