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. |
| 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. |
| Managed tables only |
When checked, models with managed = False in their
Meta class are hidden from the diagram.
|
| Show inheritance |
When checked, each model box shows its parent class(es) below the model
name. The default Django base (models.Model) is not shown —
only custom application-level parents are displayed.
|
| Excluded models |
A list of regex patterns matched against model names. Any model whose
name matches at least one pattern is hidden from the diagram. Patterns
use Python re.search — use ^ / $
to anchor. Examples: ^Historical, Log$,
Audit.
|
| Excluded apps |
Entire apps can be permanently hidden from the diagram using checkboxes.
By default the system apps (auth, admin,
sessions, contenttypes,
django_lumen) are excluded.
|
| Indigo | ForeignKey |
| Green | OneToOneField |
| Amber | ManyToManyField |