snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/user-guide/layout/capabilities/navigation.mdx

@@ -0,0 +1,49 @@
+---
+title: Sidebar
+description: Customize the left sidebar to match how your team works.
+---
+
+The left sidebar is your primary way to move around Twenty. It's fully customizable — you can reorganize it to match your workflow without touching any settings page.
+
+## Collapsing and expanding the sidebar
+
+On desktop, click the collapse button at the top of the sidebar to make more room for your records. Hover over the button to see the **Collapse sidebar** tooltip. When collapsed, the button's tooltip changes to **Expand sidebar**.
+
+You can also open the command menu with `Cmd+K` (Mac) or `Ctrl+K` (Windows), search for **sidebar**, and choose **Collapse sidebar** or **Expand sidebar**. The command reflects the sidebar's current state and closes the command menu after you select it.
+
+## Reordering items
+
+The order of items in the **Workspace** section is shared across the workspace. With the **Layouts** permission, hover over **Workspace** and click the wrench icon to enter sidebar customization mode. Drag and drop items to change their positions, then save your changes.
+
+Items in **Favorites** are personal to each user and can be reordered by dragging and dropping them without entering customization mode.
+
+## Folders
+
+Group related items into folders. For example, you might create a "Sales" folder containing your pipeline views, a "Support" folder for tickets, or an "Operations" folder for internal objects.
+
+To create a folder, right-click in the sidebar or use the `+` button.
+
+## Hiding objects
+
+Objects you don't use can be hidden from the sidebar. They're not deleted — they're just out of the way. You can show them again anytime from Settings → Data Model.
+
+## Favorites
+
+Pin views, records, or searches to the Favorites section at the top of the sidebar for one-click access. Favorites are personal — each user manages their own.
+
+## Custom links
+
+Add links to external tools directly in the sidebar. Useful for linking to your wiki, dashboards in other tools, or any URL your team uses regularly.
+
+## Command menu
+
+Press `Cmd+K` (or `Ctrl+K`) to open the command menu — a quick-access search bar for jumping to any record, view, or action without navigating the sidebar.
+
+- Choose **Copy link to page** to copy the current page URL, including its view and tab, to your clipboard.
+- Search for **theme** to switch to light, dark, or system appearance. The menu offers the themes you aren't currently using, and your choice is saved to your profile.
+
+## Customizing the sidebar
+
+To customize the sidebar, hover over the "Workspace" section in the sidebar and click the wrench icon.
+
+<img src="/images/user-guide/layout/navigation-edit-icon.png" alt="Sidebar customization icon" />

packages/twenty-docs/user-guide/layout/capabilities/record-pages.mdx

@@ -0,0 +1,68 @@
+---
+title: Record Pages
+description: Customize the layout of individual record detail pages with tabs and widgets.
+---
+
+## Overview
+
+When you open a record in Twenty, the detail page is composed of **tabs** and **widgets**. Both are fully customizable per object type.
+
+## Tabs
+
+Each record page can have multiple tabs — similar to tabs in a browser. Use them to organize different aspects of a record. For example, a Company record might have tabs for Overview, Communication, Tasks, and Files.
+
+You can:
+- Add and remove tabs
+- Rename tabs
+- Reorder tabs by dragging
+- Set which tab shows by default
+
+## Widgets
+
+Widgets are the building blocks inside each tab. Available widget types include:
+
+| Widget | What it shows |
+|--------|--------------|
+| **Fields** | Record fields, grouped or individually |
+| **Related records** | Table of records linked via a relation |
+| **Emails** | Email history from connected accounts |
+| **Calendar** | Calendar events associated with the record |
+| **Timeline** | Activity and event history |
+| **Tasks** | Associated tasks |
+| **Notes** | Rich text notes |
+| **Files** | File attachments |
+| **Charts** | Visual data from related records |
+| **iFrame** | Embedded external content |
+| **Rich text** | Static content or descriptions |
+
+### Editing related records
+
+Related-record table and kanban widgets are editable by default. To make one read-only:
+
+1. Open the record page layout editor
+2. Select the related-record widget
+3. Turn off **Allow editing** under **Data and display**
+
+For tables, this prevents cell editing. For kanban boards, it prevents editing cards, moving them between columns, and creating records. Role permissions still apply when editing is allowed.
+
+## Customizing a record page
+
+1. Open any record
+2. Press `Cmd+K` and search for "Edit record page layout"
+
+or
+
+1. Go to Settings → Data Model → object of your choice → Layout
+2. Click the "Customize record page" button for that object
+
+3. You're now in customization mode:
+   - **Add widgets** from the widget picker
+   - **Drag widgets** to reposition them on the grid
+   - **Resize widgets** by dragging their edges
+   - **Configure fields** shown within each widget
+   - **Manage tabs** — add, remove, rename, reorder
+4. Save your changes — they apply to all records of that object type
+
+## Field visibility
+
+Within a Fields widget, you can control which fields are visible and in what order. This lets you create focused layouts — for example, showing only the most important fields on the Overview tab and putting detailed fields in a separate tab.

packages/twenty-docs/user-guide/layout/overview.mdx

@@ -0,0 +1,47 @@
+---
+title: Layout
+description: Customize how you navigate, browse, and view records in Twenty.
+---
+
+Twenty's layout is customizable at three levels: how you navigate the app, how you browse lists of records, and what you see when you open an individual record.
+
+<span id="navigation" />
+
+## Sidebar
+
+The left sidebar is fully customizable. You can:
+- **Reorder items** by dragging and dropping
+- **Create folders** to group related objects and views
+- **Hide objects** you don't use
+- **Add custom links** to external tools
+- **Pin favorites** for quick access to views, records, or searches
+- **Collapse or expand the sidebar** from its button or the command menu
+
+[Sidebar reference →](/user-guide/layout/capabilities/navigation)
+
+## Views
+
+Views control how lists of records are displayed. Twenty supports three view types:
+
+| View | Best for |
+|------|----------|
+| **Table** | Working with many records at once — spreadsheet-style rows and columns |
+| **Kanban** | Pipeline tracking — drag-and-drop cards organized by stage |
+| **Calendar** | Time-based planning — records plotted by a date field |
+
+Each view saves its own filters, sorting, field visibility, and grouping configuration. Views can be shared with the workspace or kept private.
+
+[Table views →](/user-guide/views-pipelines/capabilities/table-views) · [Kanban views →](/user-guide/views-pipelines/capabilities/kanban-views) · [Calendar view →](/user-guide/views-pipelines/capabilities/calendar-view)
+
+## Record pages
+
+When you open a record, the detail page is built from configurable tabs and widgets. You can:
+
+- **Add, remove, and reorder tabs** on any record type
+- **Configure widgets** — fields, related records, emails, timeline, calendar, tasks, notes, files, charts, iFrames, and more
+- **Drag and resize widgets** on a grid layout
+- **Control field visibility** per widget
+
+Enter layout customization mode from the command menu (`Cmd+K` → "Edit record page layout").
+
+[Record pages reference →](/user-guide/layout/capabilities/record-pages)