As you probably know, we have been working on a new user experience for our documentation portal. We are now releasing the first version of the portal. There are still many things that we want to build into the portal in the not-too-far-off future. But we believe this first version will already make learning about and building on top of IOTA a much better experience.

Enjoy a more streamlined experience, in line with the IOTA ecosystem.

We wanted to make sure the look and feel of the website is what you’re used to when using our wallet, Trinity, or visiting the main website.

Documentation portal landing page

We have also built a whole new stylesheet with reusable components, to make developing other experiences in the IOTA ecosystem a breeze.

Have a much better user experience, both mobile and wide-screen desktop.

The website is built to be usable whether you are on the go, or building great things in your office! Individual elements adjust as you’d expect to provide a great reading experience.

Search for the information you need

Convenient information discovery is one of the most important parts of a great documentation portal. We’ve implemented search that works flawlessly on desktop and mobile.

Searching for content

Go through the content from basic to advanced in a book-like reading fashion.

Some of the input we received during our community developer interviews was that you enjoy book-like reading in documentation. We made this happen in the portal, and you can go from one page to the following in a logical flow. The site will guide you through your learning experience.

Reading content in a book-like fashion

Provide feedback on the content you visit.

We’re always interested in getting your feedback on the content you’re interested in. You can now submit feedback for every page on the site. We’ll make sure to use this input to improve the content. So if there’s something missing, or if you like what you read, please let us know!

Read on some of the newly added content.

We’ve been hard at work adding more content these past few weeks. As well as improving the existing content, like the IRI documentation.

Even more guides and examples are coming in the near future, but for now, be sure to check the new docs for Hub and for Compass.


As always, we are more than happy if you contribute to our documentation. You can find all the content hosted on the documentation-markdown repository. See our contribution guidelines for more information on how to contribute.

What’s next:

Work on the portal will be an ongoing process and we already have plans for the near future:

  • Support for suggesting specific changes to existing content.
  • Further improving, and speeding up the search experience.
  • Changing up labeling of existing content to be more accessible to new users.
  • Building scenarios that run directly in the browser. So you can learn and try new things right away.
  • And more!

Make sure you visit the new documentation portal! And thanks to everyone, especially our focus group, for their feedback during the development.

A huge thanks goes to the development team that worked on this feature; Alexey Sobolev, Andrew Brough, Casper Eicke Frederiksen, Giorgio. E. Mandolfo, Lewis Freiberg, Max Appel, Jake Cahill, Marwen Trabelsi, Martyn Janes, Rihard Gravis, S. D. Nelson, and others in the IF!

Please join the discussion in the #Documentation channel of the IOTA Discord server.

Welcome to the new IOTA documentation portal was originally published in IOTA on Medium, where people are continuing the conversation by highlighting and responding to this story.

Welcome to the new IOTA documentation portal was originally published on——2. The IOTA-News Community curates, examines, and summarizes news from external services while producing its own original material. Copyrights from external sources will be credited as they pertain to their corresponding owners. The purpose is to make use of 3rd party content or pictures as either allusion or promotional endorsement of mentioned sites. If you have a claim of copyright infringement with respect to material, please mail to support[at] is a community run website and is NOT affiliated with the IOTA Foundation in any way.