Advertising FAQ

How are ads priced?

We price ads on a cost per click (CPC) basis. The exact cost depends on the targeting parameters. See our prospectus for details.

How can I target my ads?

In line with our ethical advertising approach, we believe that ads can be well targeted while respecting users' privacy. We only target based on a user's country and the content of the page where the ad is served. This is a very powerful approach and allows combinations such as ads on Python or JavaScript documentation served to developers in the USA and Canada or ads on C# and Visual Basic documentation to developers in Austria and Germany.

For ads targeting the USA, we also support targeting by state or by metro area (DMA specifically).

We are beta testing targeting to specific projects or specific keywords. If you are interested in participating, please let us know.

What are the ad specifications?

For image ads, we display a 240x180px PNG image and up to 80 characters of supporting text. Supporting text can be linked in its entirety, or words can be linked selectively. The image will be linked to the same page as the supporting text.

For ads in the page footer, we display a 240x180px PNG image and up to 300 characters of text. Line breaks are supported. The text should have words or phrases linked selectively. The image will be linked to the same page as the text.

Where do the ads link to?

The ads can link to any URL. Typically they will link to your landing page on your website. You may include UTM parameters or other URL parameters to know that the traffic came from your ad on our site.

How are my ads scheduled?

We attempt to schedule the clicks evenly across time based on the length of your campaign and the number of clicks you would like to purchase. However, if you want to get as many clicks as possible as fast as possible, we can definitely do that.

Can I run my ad JavaScript on Read the Docs?

In order to respect our users' privacy, we do not allow any third-party ad scripts to run on Read the Docs.

How can I see how my ads are performing?

Once you become an advertiser with us, you will have access to view live reports on the performance of your ads including how many times they were viewed and clicked.

Where do my ads appear?

Ads appear on individual documentation microsites. More specifically, your ad will appear in the left navigation or the footer.

What type of ads are acceptable?

We want ads that are of interest to our audience of millions of software developers.

Read the Docs has final approval for all ads with respect to editorial and creative content but generally this isn't an issue.

Can I post an ad promoting my job openings?


Do my ads have to be in English?

They can be in any language you like including Spanish, Chinese, Java, Ruby, or French.

Do my ads support open source?

Read the Docs is open source software and the ads go to support development of RTD itself as well as our significant hosting costs.

We also give away 10% of our ad space for free to community projects including non-profit developer conferences, open source projects, and more. Send us an email to be considered for our Community Ads program.

How can I get started advertising on RTD?
We thought you'd never ask. Simply fill out our advertising information form. A member of our team will contact you with a detailed prospectus and will walk you through the process of getting started advertising on Read the Docs.

Advertise with us