Documentation update (#20059)

Add missing info about how to edit navigation bar, add many-to-many
relation and get Enterprise key for Org license on self-hosted

---------

Co-authored-by: Charles Bochet <charles@twenty.com>

Author: BOHEUS

packages/twenty-docs/images/user-guide/billing/enterprise-key.png

@@ -17,13 +17,13 @@ For teams ready to scale:
 - Standard support
 
 <Note>
-Premium features (SSO and row-level permissions) are not included in the Pro plan.
+Premium features (SSO, row-level permissions and AI usage data) are not included in the Pro plan.
 </Note>
 
 ### Organization (Cloud)
 For larger teams with advanced needs:
 - Everything in Pro
-- **Premium features**: SSO integration and row-level permissions
+- **Premium features**: SSO integration, row-level permissions and AI usage data
 - Priority support
 
 ## Self-Hosted Plans
@@ -37,7 +37,7 @@ Host Twenty on your own infrastructure at no cost:
 ### Organization (Self-Hosted)
 For teams who need premium features while self-hosting:
 - All Pro features
-- **Premium features**: SSO integration and row-level permissions
+- **Premium features**: SSO integration, row-level permissions and AI usage data
 - Twenty team support
 - No requirement to publish custom code as open-source before distributing
 
@@ -46,6 +46,7 @@ For teams who need premium features while self-hosting:
 Premium features are only available on the Organization plans (Cloud or Self-Hosted):
 - **SSO integration**: Single Sign-On with your identity provider
 - **Row-level permissions**: Fine-grained access control at the record level
+- **AI usage data**: Track AI consumption across the workspace
 
 ## Switching Plans
 
@@ -65,3 +66,15 @@ Contact support to downgrade your plan.
 ### Switch to Monthly Billing
 Contact support to switch back to monthly billing.
 
+## Obtain an Enterprise Key for Organization (Self-Hosted)
+
+To use the Organization (Self-Hosted) plan, you need to obtain an Enterprise key:
+
+1. Go to **Settings → Admin Panel → Enterprise**
+
+<img src="/images/user-guide/billing/enterprise-key.png" alt="Enterprise key" />
+
+2. Click **Get Enterprise Key**
+3. When you are redirected to Stripe, enter your payment details and confirm
+4. When your Enterprise key is displayed, paste it into the Enterprise settings page and activate the Organization license
+

packages/twenty-docs/images/user-guide/fields/junction-relation-toggle.png

@@ -16,6 +16,11 @@ If you want to self-host and need the Premium features (SSO and row-level permis
 Premium features are only available on the Organization plans (Cloud or Self-Hosted):
 - **SSO integration**: Single Sign-On with your identity provider
 - **Row-level permissions**: Fine-grained access control at the record level
+- **AI usage data**: Track AI consumption across the workspace
+</Accordion>
+
+<Accordion title="Is Organization plan on cloud and Organization plan on self-hosted the same?">
+They offer the same premium features. However, a cloud subscription cannot be used for self-hosted deployments. Self-hosted requires an Enterprise key.
 </Accordion>
 
 <Accordion title="Do you offer free seats for view-only users?">

packages/twenty-docs/images/user-guide/fields/new-pivot-object.png

@@ -52,38 +52,45 @@ First, create the intermediate object that will hold the connections.
 1. Go to **Settings → Data Model**
 2. Click **+ New object**
 3. Name it descriptively (e.g., "Project Assignment", "Team Member", "Product Order")
-4. Click **Save**
+4. Toggle "Skip creating a Name field" on
+
+<img src="/images/user-guide/fields/new-pivot-object.png" alt="New pivot object" />
+
+5. Click **Save**
 
 <Tip>
 **Naming convention**: Use a name that describes the relationship, like "Project Assignment" or "Team Membership". This makes the data model easier to understand.
 </Tip>
 
-## Step 2: Create Relations from the Junction Object
+## Step 2: Create Relations Between Objects and the Junction
 
-Add relation fields from the junction object to both objects you want to connect.
+Add relation fields from each of your two objects to the junction object.
 
-### First Relation (Junction → Object A)
+### First Relation (Object A → Junction)
 
-1. Select your junction object in **Settings → Data Model**
-2. Click **+ Add Field**
-3. Choose **Relation** as the field type
-4. Select the first object (e.g., "People")
-5. Set the relation type to **Many-to-One** (many assignments can link to one person)
-6. Name the fields:
-   - Field on junction: e.g., "Person"
-   - Field on People: e.g., "Project Assignments"
-7. Click **Save**
+1. Select your first object in **Settings → Data Model**
+2. Click **+ Add Relation**
+3. Select the junction object (e.g., "Project Assignments")
+4. Set the relation type to **One-To-Many** (one person can link to many assignments)
+5. Name the fields:
+    - Field on People: e.g., "Project Assignments"
+    - Field on junction: e.g., "Person"
+6. Click **Save**
 
-### Second Relation (Junction → Object B)
+### Second Relation (Object B → Junction)
 
-1. Still on the junction object, click **+ Add Field**
-2. Choose **Relation** as the field type
-3. Select the second object (e.g., "Projects")
-4. Set the relation type to **Many-to-One**
-5. Name the fields:
+1. Select your second object in **Settings → Data Model**
+2. Click **+ Add Relation**
+3. Select the junction object (e.g., "Project Assignments")
+4. Set the relation type to **One-To-Many** (one project can link to many assignments)
+5. Enable **"This is a relation to a Junction Object"**
+
+<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}}/>
+
+6. Name the fields:
    - Field on junction: e.g., "Project"
    - Field on Projects: e.g., "Team Members"
-6. Click **Save**
+7. Click **Save**
 
 ## Step 3: Configure the Junction Relation Display
 
@@ -97,18 +104,6 @@ Now configure the source objects to display linked records directly, skipping th
 6. Select the **Target relation** (e.g., "Project" — the field on the junction that points to the other side)
 7. Click **Save**
 
-
-{/* TODO: Add image
-<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}}/>
-*/}
-
-Repeat for the other object:
-1. Select "Projects" in Data Model
-2. Edit the "Team Members" relation field
-3. Enable the junction toggle
-4. Select "Person" as the target relation
-5. Save
-
 ## Result
 
 After configuration:
@@ -127,15 +122,15 @@ Here's a complete walkthrough:
 - Description: "Links people to projects they work on"
 
 ### Add Relations
-1. **Project Assignment → People**
-   - Type: Many-to-One
-   - Field on Assignment: "Person"
+1. **People → Project Assignment**
+   - Type: One-to-Many
    - Field on People: "Project Assignments"
+   - Field on Assignment: "Person"
 
-2. **Project Assignment → Projects**
-   - Type: Many-to-One
-   - Field on Assignment: "Project"
+2. **Projects → Project Assignment**
+   - Type: One-to-Many
    - Field on Projects: "Team Members"
+   - Field on Assignment: "Project"
 
 ### Configure Junction Display
 1. On **People** object:

packages/twenty-docs/images/user-guide/layout/navigation-edit-icon.png

@@ -30,3 +30,9 @@ Add links to external tools directly in the sidebar. Useful for linking to your
 ## 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.
+
+## 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="Navigation edit icon" />

packages/twenty-docs/user-guide/billing/capabilities/pricing-plans.mdx

@@ -3,6 +3,8 @@ 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
@@ -37,6 +39,12 @@ Widgets are the building blocks inside each tab. Available widget types include:
 
 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