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

packages/twenty-docs/user-guide/dashboards/how-tos/dashboards-faq.mdx

@@ -0,0 +1,55 @@
+---
+title: Dashboards FAQ
+description: Frequently asked questions about dashboards in Twenty.
+---
+
+<AccordionGroup>
+  <Accordion title="Can I create private dashboards?">
+    No, dashboards are currently visible to everyone with access to your Twenty workspace. Private dashboards are not yet available.
+  </Accordion>
+
+  <Accordion title="Why do my metrics look different from my colleague's?">
+    Dashboards currently display data based on the viewer's timezone. If you're in different regions (e.g., APAC vs. US), you may see slightly different numbers for the same dashboard. We're working on adding a timezone setting per dashboard to ensure consistent data across teams.
+  </Accordion>
+
+  <Accordion title="Can I export my dashboard?">
+    Exporting dashboards is not available at the moment. This feature is on our roadmap.
+  </Accordion>
+
+  <Accordion title="Can I share dashboards with external users?">
+    No, sharing dashboards with users outside your Twenty workspace (non-Twenty users) is not currently supported.
+  </Accordion>
+
+  <Accordion title="How do I add a dashboard to my favorites?">
+    Open the dashboard you want to favorite, then click the star icon. Favorites are personal—they won't affect other users.
+  </Accordion>
+
+  <Accordion title="What's the difference between tabs and widgets?">
+    - **Tabs** organize your dashboard into sections (like pages within the dashboard)
+    - **Widgets** are the individual visualizations (charts, numbers, iFrames) within each tab
+
+    Structure: Dashboard → Tabs → Widgets
+  </Accordion>
+
+  <Accordion title="Can I filter an entire dashboard at once?">
+    Dashboard-level filters are not available yet, but this feature is on our roadmap. Currently, you need to apply filters to each widget individually.
+  </Accordion>
+
+  <Accordion title="Are gauge charts available?">
+    Not yet. Gauge charts are on our roadmap and will be added in a future release.
+  </Accordion>
+
+  <Accordion title="How do I duplicate a dashboard?">
+    1. Make sure you're in view mode (not editing)
+    2. Open the command bar with **Cmd + K** (or **Ctrl + K** on Windows)
+    3. Select **Duplicate dashboard**
+  </Accordion>
+
+  <Accordion title="How often does dashboard data refresh?">
+    Widgets update automatically as your CRM data changes:
+    - Real-time updates for most metrics
+    - Use the refresh button for a manual update if needed
+    - Historical data is preserved for trend analysis
+  </Accordion>
+</AccordionGroup>
+

packages/twenty-docs/user-guide/dashboards/how-tos/widget-faq.mdx

@@ -0,0 +1,67 @@
+---
+title: Widget FAQ
+description: Common questions and error messages explained.
+---
+
+<AccordionGroup>
+  <Accordion title="How do I show percentages instead of counts?">
+    Three options:
+
+    - **Percent empty/not empty**: Under Data on display, select Percent empty or Percent not empty
+    - **Ratio**: For Select or Checkbox fields, enable Ratio to show a specific option as a percentage of all records
+    - **Suffix**: For aggregate charts, add `%` as a Suffix in Style settings
+  </Accordion>
+
+  <Accordion title="What's the difference between grouped and stacked bars?">
+    When using **Group by**, you can display series two ways:
+
+    - **Grouped**: Bars side by side—best for comparing exact values
+    - **Stacked**: Bars on top of each other—best for showing composition
+
+    Toggle **Stacked** in Style settings to switch.
+  </Accordion>
+
+  <Accordion title="Why can't I see Sum or Average options?">
+    Available operations depend on **field type**:
+
+    - **Number fields**: Sum, Average, Min, Max
+    - **Date fields**: Earliest, Latest (aggregate charts only)
+    - **Checkbox fields**: Count true, Count false
+
+    If you don't see an option, check that you've selected a compatible field type.
+  </Accordion>
+
+  <Accordion title="Why are some settings grayed out or missing?">
+    Many settings only appear when prerequisites are met:
+
+    - **Date granularity**: Select a date field first
+    - **Group by, Legend, Stacked**: Set Source first
+    - **Legend, Stacked toggles**: Set Group by first
+
+    If a setting is missing, configure its prerequisite first.
+  </Accordion>
+
+  <Accordion title="What does 'No data' mean?">
+    The chart found no records matching your configuration.
+
+    **To fix:** Remove or adjust filters, verify you selected the correct Source object, or check that records exist for your date range.
+  </Accordion>
+
+  <Accordion title="What does 'Invalid configuration' mean?">
+    A required setting is missing or incompatible.
+
+    **To fix:** Ensure Source is set, Data on display is configured, and any required grouping fields are selected.
+  </Accordion>
+
+  <Accordion title="What does 'Undisplayed data' mean?">
+    Your data exceeds display limits (100 bars, 100 data points, or 100 slices).
+
+    **To fix:** Add filters to narrow your data, or change date granularity from Day to Week or Month.
+  </Accordion>
+
+  <Accordion title="Why is one axis showing no data?">
+    The selected field has no values for the records in your filter, or the field type doesn't match the expected data.
+
+    **To fix:** Try a different field, or check that records have values for the selected field.
+  </Accordion>
+</AccordionGroup>