Roadmap & Release Notes


πŸš€ Upcoming

  • Allow users to update their username
  • Export database diagrams
  • Export database documentation
  • Display table groups & header colors in diagram

πŸ“¦ Backlog

  • Project changelogs
  • Collaboration
  • Dark mode

Release Notes

πŸ›  Custom Username - Aug 25, 2022

After registration, your username is strictly set to your email or GitHub username. The constant username could be a problem for users who need specific usernames for organizational usage.

Therefore, we’re introducing a new CLI command to change your username (as well as your organization name). From the dbdocs CLI version 0.6.4, you can run dbdocs rename and freely switch to an available username.

Feel free to show some love or feedback in the feature announcement on our community.

πŸ–Ό Export Diagrams as PNG/PDF - Aug 25, 2022

Today, our team is bringing in a new feature: Diagram Export. Users now have the option to download their diagrams as PDF and PNG files.

Simply hover on the download button at the top-right corner of diagram views, then choose either PDF or PNG as your desired format.

Feel free to show some love or feedback in the feature announcement on our community.

πŸ”Œ Support for Many-to-many Relationships - June 06, 2022

dbdocs now supports Many-to-many Relationships!

When drawing the many-to-many relationship, you no longer need to create an associative (join) table. Instead, just define it directly, such as:

Table books {
  id int [pk]

Table authors {
  id int [pk]

Ref books_authors: <> // many-to-many

For more DBML syntax updates, please check out our docs!

πŸ—‚ Support for Multiple Schemas - Mar 17, 2022

Today we provide you with another powerful tool for documenting your database - Multiple Schemas.

Previously you could only define the table names, and when loaded into dbdocs it falls into the default β€œpublic” schema.

Now, you can define the tables with full schema names:

Table ecommerce.products {

Moreover, you can make cross-schemas relationships and use enums from different schemas.

Table orders {
  id int [pk, ref: < ecommerce.order_items.order_id]
  status core.order_status

Enum core.order_status {

For more DBML syntax updates, please check out our docs!

πŸ“– Support Markdown for table/field notes - Oct 11, 2021

The recent outbreak in our country is severe, but that doesn't stop us from improving dbdocs. This time, we bring you the Markdown support for the notes of tables & fields.

Now you can restructure your notes by styling your texts, adding code blocks for database scripts, related links, and so much more.

πŸ—ƒ Project list - Sep 12, 2021

Manage better & view all your database projects via new project list views.

Simply run the dbdocs ls command on the dbdocs CLI version 0.6.1

Or open your organization page by selectΒ "My Projects"Β in the account dropdown menu

πŸ’Ύ Save diagram's table positions - Aug 24, 2021

Your savior, a.k.a save diagram's table positions, is here!

It's very time-consuming before to always move tables around at the beginning of each session.

Now you can sign in & modify the diagram's table positions in your projects. Then every time you & your guests visit, the arrangement in diagrams will stay still.

πŸ“¦ Composite foreign keys - Jul 14, 2021

Due to the dbml syntax gap between our dbdocs & dbml/core, users couldn't use the composite foreign keys.

Guess what? Now you will have the ability to document relationships with composite keys, like the example below:

Ref: merchant_periods.(merchant_id, country_code) > merchants.(id, country_code)

πŸ” Search for everything - May 12, 2021

Good news! You can search for fields, notes in dbdocs now.

Due to the lack of search capability, many users have got lost in large, complex databases. If you have too many fields, you won't find the one you want.

Besides lookup by table names, support search by field names, notes are our improvements in this release. We also support the case-insensitive search for getting better results.

πŸšͺ Login via Email - Apr 26, 2021

Since login via GitHub is the single option, many users have to use theirs personal GitHub account or even create a new one for documentation purposes.

With the dbdocs CLI version 0.5.0, feel free to connect dbdocs with your work email & improve the workflow now!

πŸ“š dbdocs's Documentations - Mar 28, 2021

For better features awareness & roadmap tracking, it's time to release our documentations!

πŸ”„ CI Integration - Mar 7, 2021

Previously you couldn’t set up CI/CD with Gitlab, GitHub Actions, or CI server to automatically generate the docs, because our login process required a web browser and UI.

The dbdocs CLI version 0.4.0 now supports you to build documentation with your unique access token!

Read more about CI Integration in our docs.