Feature Release: Table Header Color and Table Group

[Thi_Nguyen]

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 {
  ecomm_core.products
  ecomm_core.product_tags
}

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!

[anthony]

Would it be possible to change the colour of a table group, in the same way the table header is defined?

So you would have

TableGroup my_group [color: #8F8DD8] {
   table_1
   table_2
   ...
}

[Phuc_Nguyen]

Hi Anthony,

Currently, the coloring of table groups is not supported yet. We’ll consider implementing it in the future and will let you know when it’s ready.

Thanks.

[Tommy]

Phuc, Table Groups really need a note feature as well.

It makes sense that you can describe what a table group is all about within a project.
(much like project notes, table notes or column notes)

It looks odd on DBDocs that a description cant be added below them

[Huy_Phung]

Hi Tommy,

Thank you for your suggestions.
It would be useful to have the capability for adding notes to table groups. We took note of it and will consider it in the future.

In the meanwhile, you can use our sticky notes function as a workaround: https://dbml.dbdiagram.io/docs/#sticky-notes

Best Regards,
Huy Phung

[Thi_Nguyen]

Hi @anthony and @Tommy, I have good news.

Update September 2024: These features have been developed and released. Please see below for the official announcement.

I hope you guys like this feature.

Support Notes & Color for Table Groups

Recognizing that table groups could be more useful and elegant, you can now enjoy Table Group Notes and Color. [table-groups-notes-and-color] Table Group Color No more boring, grayed-out table groups that are difficult to spot when zoomed out, as you can now make them more colorful and distinct. You can directly pick a color for your table group or use the following syntax: TableGroup "Order Management" [color: #E74C3C] { ... } [select-color-for-table-group] Table Group Notes Add Markdow…

[Estudiante_Medicina]

I found a problem in the dbdiagram VS Code extension preview.

When I define headercolor directly in the DBML file, the preview renders the tables and relationships correctly, but it does not apply the header colors.

Minimal example:

Project dbml_headercolor_preview_minimo {
database_type: “PostgreSQL”
}

Table teste.usuarios [headercolor: #1565C0] {
id uuid [pk]
email varchar(255) [not null, unique]
criado_em timestamptz [not null]
}

Table teste.pedidos [headercolor: #C62828] {
id uuid [pk]
usuario_id uuid [not null]
descricao varchar(255)
criado_em timestamptz [not null]
}

Ref: teste.pedidos.usuario_id > teste.usuarios.id

Expected:

• teste.usuarios should appear with a blue header
• teste.pedidos should appear with a red header

Observed:

• the preview displays the diagram normally
• relationships are rendered normally
• both table headers appear without the configured colors

I also tried changing the color from the preview UI. The color appears while the table is selected, but after deselecting the table, the color disappears again.

So the issue seems to be specifically related to color rendering/persistence in the VS Code preview, not to the DBML structure itself.

[Thi_Nguyen]

Thank you for raising this.

We just checked the table header color and it seems to be working fine. Just a heads up, the header colors available with a paid plan. So, make sure you log in to dbdiagram with the extension and have a paid plan to use them.