Roadmap & Release Notes


πŸš€ Upcoming

  • Support table header color & table group
  • Publish/Update docs via dbdiagram
  • dbdocs Pricing Plans
  • Project changelogs

πŸ“¦ Backlog

  • Export database documentation
  • Collaboration
  • Dark mode

Updated: 18 April 2023

Release Notes

πŸš€ Publish database documents via dbdiagram - Apr 18, 2023

Many users asked us to link dbdocs and dbdiagram (our other product that allows you to draw ER diagrams by writing code) to improve the editing experience with online editing and collaboration features.

And we couldn't agree more. That's why we worked so hard to bring you our new feature: the ability to publish your database documents via dbdiagram.

In addition to editing your database definition (DBML) on your local machine and publishing it via the dbdocs CLI, you can now use dbdiagram as an online editor to quickly edit your database documentation.


  1. What happens if I update a diagram after publishing it to dbdocs? Will the dbdocs document automatically update?

    Changes to your diagram will not automatically update the dbdocs document.

  2. What if I don't already have a dbdiagram account?

    You’ll need to log in to the dbdiagram using your email address to get the project list from the dbdocs account associated with your email.

As always, we appreciate your comments and suggestions. Please give this feature a shot and let us know what you think.

🎨 Support Table Header Color and Table Group - Feb 16, 2023

We heard you! Table Header Color and Table Group are now available in dbdocs! These two are well-loved features in dbdiagram, and are most requested by our dbdocs community.

With this, you can add a custom color to your table headers and group tables together to better organize your data models.

Table Header Color

Choose a custom header color for each of your tables! This allows you to differentiate between tables and create more visually appealing documentation.

To set the header color for a table, use the following syntax:

Table ecomm_core.products [headercolor: #087f23] {

Table Group

Group tables together into categories! Keep your data models organized and maintain clean, clear documentation.

To group tables, use the following syntax:

TableGroup product_group {

These features are immediately available for everyone. However, similar to dbdiagram, they might be moved to a paid offering when we introduce paid plans in dbdocs in the next couple of months.

Give them a try and let us know what you think!

πŸ›  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 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 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.