How to use the diagram
A quick reference for navigating and customising the ERD view.
| Scroll wheel |
Zoom in / out around the cursor position. |
| Drag on empty canvas |
Pan the diagram in any direction. |
|
↑ ↓ ← →
|
Pan the canvas with the keyboard arrow keys (120 px per press; hold for continuous scroll). |
| Click table header |
Enters focus mode: the selected table and all its directly related tables
are highlighted; everything else is dimmed. The viewport automatically
zooms in to fit the visible group.
|
| Click a related table header |
Switches focus to that table and its neighbours. |
| Click the focused table header again |
Clears focus mode and zooms back out to the full diagram. |
| Double-click field list |
Opens a detail panel for that table showing each field's verbose name,
help text, and available choices (for TextChoices /
IntegerChoices fields), followed by a full list of
database indexes and constraints.
|
| Click × or Esc |
Closes the detail panel. Clicking outside the panel also closes it. |
| Click an app chip |
Filters the diagram to show only tables belonging to the selected app(s)
plus any tables they have direct relations to. Click again to deselect.
When no chips are selected, all tables are shown.
|
| Right-click an app chip |
Marks the app as excluded (shown in red with strikethrough).
Excluded apps are completely hidden from the diagram. Right-click again
to un-exclude. Preferences are saved automatically.
|
| Managed tables only |
When checked, models with managed = False in their
Meta class are hidden from the diagram. Useful for
filtering out database views and legacy tables that Django does not
manage.
|
| Curved (default) |
S-shaped Bézier curves between tables. |
| Orthogonal |
Right-angle routing; parallel trunks are offset to avoid overlap. |
| Oblique |
Lines exit horizontally then connect diagonally to the target. |
| Direct |
Straight lines from port to port. |
| Auto-save |
The selected app filter, excluded apps, and line routing style are saved
automatically to your account (debounced 600 ms) and restored on your
next visit.
|
| Manage excluded apps |
Use the settings page to permanently hide entire apps from the diagram
using checkboxes. By default the system apps
(auth, admin, sessions,
contenttypes, django_lumen) are excluded.
|
| Indigo |
ForeignKey |
| Green |
OneToOneField |
| Amber |
ManyToManyField |
Tip: Relations shown in the diagram are sourced live from
Django's model registry at request time — the diagram always reflects the
current state of your codebase without any manual refresh.