Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions packages/twenty-docs/docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -164,6 +164,7 @@
"group": "CRM Automations",
"pages": [
"user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due",
"user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review",
"user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received",
"user-guide/workflows/how-tos/crm-automations/formula-fields",
"user-guide/workflows/how-tos/crm-automations/display-related-record-data",
Comment on lines 164 to 170

This comment was marked as outdated.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Per my understanding, we're not supposed to edit anything that is not the English version as this will be done automatically afterwards. Would love your review either @FelixMalfait or @abdulrahmancodes please

Expand Down Expand Up @@ -322,7 +323,7 @@
"user-guide/settings/capabilities/profile-settings",
"user-guide/settings/capabilities/experience-settings",
"user-guide/settings/capabilities/domains-settings",
"user-guide/settings/capabilities/releases-settings"
"user-guide/settings/capabilities/updates-settings"
]
},
{
Expand Down Expand Up @@ -6639,7 +6640,7 @@
},
{
"source": "/user-guide/settings/releases-settings",
"destination": "/user-guide/settings/capabilities/releases-settings"
"destination": "/user-guide/settings/capabilities/updates-settings"
},
{
"source": "/user-guide/settings/settings-faq",
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 2 additions & 1 deletion packages/twenty-docs/navigation/base-structure.json
Original file line number Diff line number Diff line change
Expand Up @@ -151,6 +151,7 @@
"label": "CRM Automations",
"pages": [
"user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due",
"user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review",
"user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received",
"user-guide/workflows/how-tos/crm-automations/formula-fields",
"user-guide/workflows/how-tos/crm-automations/display-related-record-data",
Expand Down Expand Up @@ -329,7 +330,7 @@
"user-guide/settings/capabilities/profile-settings",
"user-guide/settings/capabilities/experience-settings",
"user-guide/settings/capabilities/domains-settings",
"user-guide/settings/capabilities/releases-settings"
"user-guide/settings/capabilities/updates-settings"
]
},
{
Expand Down
3 changes: 2 additions & 1 deletion packages/twenty-docs/navigation/navigation-schema.json
Original file line number Diff line number Diff line change
Expand Up @@ -151,6 +151,7 @@
"label": "CRM Automations",
"pages": [
"user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due",
"user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review",
"user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received",
"user-guide/workflows/how-tos/crm-automations/formula-fields",
"user-guide/workflows/how-tos/crm-automations/display-related-record-data",
Expand Down Expand Up @@ -329,7 +330,7 @@
"user-guide/settings/capabilities/profile-settings",
"user-guide/settings/capabilities/experience-settings",
"user-guide/settings/capabilities/domains-settings",
"user-guide/settings/capabilities/releases-settings"
"user-guide/settings/capabilities/updates-settings"
]
},
{
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,14 @@ Depending on your mailbox settings, you might see:

## Email Sync Behavior

### Sync Rate
Twenty imports emails at approximately **400 messages per minute**. This rate is currently limited by Gmail API rate limiting (and applies similarly to other providers).

For reference:
- 1,000 emails → ~2.5 minutes
- 10,000 emails → ~25 minutes
- 50,000 emails → ~2 hours

### What Gets Synced
- **External Emails**: All emails with contacts outside your organization
- **Automatic Linking**: Emails connect to existing People and Company records
Expand All @@ -54,10 +62,10 @@ Depending on your mailbox settings, you might see:
- **Group Emails**: Distribution lists and group emails are excluded
- **Excluded Folders**: Folders you've chosen not to sync (configured under Settings → Accounts → Email)

### Selective Folder Sync (Lab Feature)
### Selective Folder Sync
Control which email folders sync with Twenty:
1. Enable `Message Folder` in Settings → Releases → Lab
2. Configure folders under Settings → Accounts → Email
1. Go to **Settings → Accounts** and select your connected email account
2. Configure folders under the Email section
3. Choose specific folders to include or exclude (Inbox, Sent, Archive, custom folders)


Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Twenty supports **unlimited email accounts per user**. This is useful if you man
Each connected mailbox has its own settings:
- **Email visibility**: Choose what teammates can see
- **Contact auto-creation**: Enable/disable per mailbox
- **Folder selection**: Choose which folders to sync (Lab feature)
- **Folder selection**: Choose which folders to sync

## How Emails Appear

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,12 @@ description: Troubleshooting missing emails on records.
## Common Reasons

### 1. Initial Sync Still in Progress
Email sync takes time, especially for large mailboxes.
Email sync takes time, especially for large mailboxes. Twenty imports emails at approximately **400 messages per minute** (limited by Gmail API rate limiting).

- **Calendar sync**: Completes in minutes
- **Email sync**: Can take several hours for large mailboxes
- **Email sync**: Depends on mailbox size (e.g., 10,000 emails ≈ 25 minutes, 50,000 emails ≈ 2 hours)

**Solution**: Wait up to a few hours for the initial import to complete.
**Solution**: Wait for the initial import to complete. You can estimate timing based on your mailbox size.

### 2. Contact Doesn't Exist in Twenty
Emails only appear on existing People records. If the contact wasn't created yet:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,7 @@ By default, Twenty syncs all external emails from your connected mailbox. You ca

Control which email folders sync with Twenty:

1. Go to **Settings → Releases → Lab**
2. Enable **Message Folder**
3. Return to **Settings → Accounts**
1. Go to **Settings → Accounts**
4. Select your connected email account
5. Choose which folders to sync:

Expand Down
16 changes: 7 additions & 9 deletions packages/twenty-docs/user-guide/calendar-emails/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -30,11 +30,10 @@ image: /images/user-guide/emails/emails_header.png

### SMTP/CalDAV Setup (Other Providers)
For other email and calendar providers:
1. Go to **Settings → Releases → Lab** to enable the feature
2. Return to **Settings → Accounts**
3. Configure SMTP settings for email
4. Configure CalDAV settings for calendar
5. Test the connection
1. Go to **Settings → Accounts**
2. Configure SMTP settings for email
3. Configure CalDAV settings for calendar
4. Test the connection

### Multiple Mailboxes
- **Unlimited Accounts**: Connect multiple email accounts per user
Expand Down Expand Up @@ -64,10 +63,9 @@ Choose different levels of visibility for your emails:

<Note>When enabled, contacts are automatically linked to their Company records based on their email domain. If the company doesn't exist yet, Twenty creates it for you.</Note>

### Control which emails get sync with Message Folder Selection (Lab Feature)
### Control which emails get synced with Message Folder Selection
Control which email folders sync with Twenty:
1. Go to **Settings → Releases → Lab** and enable **Message Folder**
2. Return to **Settings → Accounts** and select your connected email account
1. Go to **Settings → Accounts** and select your connected email account
3. Choose which folders to sync:
- **Inbox**: Primary incoming emails
- **Sent**: Outgoing emails you've sent
Expand Down Expand Up @@ -114,7 +112,7 @@ Choose what will be visible to other users in your workspace:
**Updates every 5 minutes**: Both email and calendar data sync automatically every 5 minutes after the initial import.

<Note>
**Initial sync timing**: Calendar sync completes quickly (usually within minutes), while email sync takes longer for large mailboxes—up to a few hours depending on volume. Don't worry if you see contacts from calendar events appearing before your email contacts; this is normal behavior.
**Initial sync timing**: Calendar sync completes quickly (usually within minutes), while email sync takes longer for large mailboxes. Twenty imports emails at approximately **400 messages per minute** (limited by Gmail API rate limiting), so a mailbox with 10,000 emails takes about 25 minutes. Don't worry if you see contacts from calendar events appearing before your email contacts; this is normal behavior.
</Note>

## Next Steps
Expand Down
4 changes: 4 additions & 0 deletions packages/twenty-docs/user-guide/dashboards/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,10 @@ image: /images/user-guide/reporting/pie-chart.png
<img src="/images/user-guide/reporting/pie-chart.png" alt="Dashboards" />
</Frame>

<Note>
Dashboards are currently in beta. Activate them under **Settings → Updates → Early Access**.
</Note>

## Understanding Dashboards

Dashboards in Twenty provide a visual way to track your key performance metrics and gain insights from your CRM data.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,9 +32,6 @@ Favorites are records you've marked for quick access, appearing in your sidebar
## Field
A field refers to a specific area where particular data is stored for an entity.

## Integration
Integrations are built-in tools that allow you to link Twenty with other software or systems.

## Iterator
An Iterator is a workflow action that loops through an array of items, executing subsequent actions for each item in the list.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ If you have not done so when creating your workspace, connect your **Google or M
- Keep communication history visible for your team

**Using another provider?**
You can add another mailbox via SMTP or another calendar via CalDAV. You will need to activate the feature under Settings → Releases → Lab, and then go back to the Settings → Accounts tab.
You can add another mailbox via SMTP or another calendar via CalDAV. Go to **Settings → Accounts** to configure.

### Import data via csv
Use the Command menu (```Cmd + K``` or ```Ctrl + K```) to import People, Companies, Opportunities, or any custom objects via CSV.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,6 @@ On the left side, from the top to the bottom, you'll be able to:
- Have direct access to your **Favourites views**. Favourites are unique for each user.
- Switch between different objects
- **Create automations** using workflows
- Reach out to Support and open our User Guide.

<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}}/>

Expand Down Expand Up @@ -71,7 +70,9 @@ Open your Settings from the top left to:
- Invite team members and manage user roles
- Edit your profile and workspace preferences
- Configure billing and monitor workflow credits usage
- Discover the latest releases and upcoming features (under Releases → Lab tab)
- Discover and enable upcoming features (under Updates → Early Access)
- **Access Support** to reach out via live chat
- **Open the Documentation** to browse the User Guide and developer docs

<Note>If you do not see all those sections under Settings, reach out to your workspace administrator - some of them have restricted access.</Note>

This file was deleted.

Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
---
title: Updates Settings
description: Enable Early Access features in Twenty.
---

## About Updates Settings

The Updates section allows you to enable Early Access features before they're generally available.

## Early Access Features

Early Access features are capabilities that are still being tested before general availability.

**Currently in Early Access:**
- **Dashboards** — Visual reporting and analytics

### How to Enable Early Access Features
1. Go to **Settings → Updates**
2. Navigate to the **Early Access** section
3. Find the feature you want to enable
4. Toggle it on
5. The feature will be available immediately

<Note>
Early Access features may change based on user feedback. Your input helps us improve Twenty!
</Note>

## Feature Feedback

Your feedback helps improve Twenty:
- Report issues with Early Access features
- Share how you're using new features
- Suggest improvements via the community Discord

Original file line number Diff line number Diff line change
Expand Up @@ -151,19 +151,19 @@ You can configure approved access domains so team members with company email add
</Accordion>
</AccordionGroup>

## Lab Features
## Early Access Features

<AccordionGroup>
<Accordion title="What are Lab features?">
Lab features are experimental capabilities being tested before general release. They may change or be removed without notice.
<Accordion title="What are Early Access features?">
Early Access features are capabilities being tested before general release. Currently, only **Dashboards** are in Early Access. They may change based on user feedback.
</Accordion>

<Accordion title="Are Lab features safe to use?">
Lab features are functional but may have bugs or unexpected behavior. Use them cautiously in production environments.
<Accordion title="Are Early Access features safe to use?">
Early Access features are functional but may change based on user feedback. They are safe to use but may evolve before general availability.
</Accordion>

<Accordion title="How do I enable Lab features?">
1. Go to **Settings → ReleasesLab**
<Accordion title="How do I enable Early Access features?">
1. Go to **Settings → UpdatesEarly Access**
2. Find the feature you want
3. Toggle it on
4. The feature becomes available immediately
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,6 @@ image: /images/user-guide/workflows/workflow.png

Iterator lets you loop through an array of records and perform actions on each one. It's essential for workflows that need to process multiple records returned by Search Records or received via webhooks.

<Note>
Iterator is currently in beta. Activate it under **Settings → Releases → Lab**.
</Note>

## When to Use Iterator

Expand Down
Loading
Loading