{% load static %} Django Lumen β€” Help
Django Lumen ← Back to diagram

How to use the diagram

A quick reference for navigating and customising the ERD view.

🧭
Navigation β€” zoom & pan
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).
πŸ”
Focus mode β€” isolating a table
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.
πŸ“‹
Table detail view
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.
🏷️
App filter β€” sidebar chips
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.
↗️
Line routing styles
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.
βš™οΈ
Preferences & settings
Managed tables only When checked, models with managed = False in their Meta class are hidden from the diagram.
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.
🎨
Relation colours
Indigo ForeignKey
Green OneToOneField
Amber ManyToManyField