> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/AppFlowy-IO/AppFlowy/llms.txt
> Use this file to discover all available pages before exploring further.

# Customization

> Personalize AppFlowy with themes, fonts, colors, and workspace settings

## Overview

AppFlowy offers extensive customization options to make your workspace truly yours. From themes and colors to fonts and regional settings, you can tailor every aspect of your AppFlowy experience.

<Info>
  Customization settings sync across devices when using a cloud workspace, ensuring a consistent experience everywhere.
</Info>

## Theme & Appearance

### Light and Dark Mode

AppFlowy supports both light and dark themes:

<Steps>
  <Step title="Open Settings">
    Navigate to **Settings → Workspace**
  </Step>

  <Step title="Select Appearance">
    Choose from:

    * **Light**: Optimized for daytime use
    * **Dark**: Reduced eye strain in low-light environments
    * **System**: Automatically match your OS theme
  </Step>

  <Step title="Apply Changes">
    Changes take effect immediately
  </Step>
</Steps>

<CardGroup cols={2}>
  <Card title="Light Mode" icon="sun">
    Clean, bright interface perfect for well-lit environments
  </Card>

  <Card title="Dark Mode" icon="moon">
    Reduced blue light and eye strain for comfortable night use
  </Card>
</CardGroup>

### Built-in Themes

AppFlowy comes with several pre-designed themes:

* **Default**: Clean and modern
* **Dandelion**: Warm and inviting
* **Lemonade**: Fresh and vibrant
* **Community Themes**: Additional themes created by the community

#### Changing Themes

<Steps>
  <Step title="Access Theme Settings">
    Go to **Settings → Workspace → Theme**
  </Step>

  <Step title="Browse Themes">
    Click the theme dropdown to view all available themes
  </Step>

  <Step title="Preview & Select">
    Select a theme to preview it instantly
  </Step>

  <Step title="Customize Further">
    Adjust individual colors if needed (see Custom Colors below)
  </Step>
</Steps>

<Note>
  Theme selection is immediately applied—no save button needed.
</Note>

## Custom Colors

### Document Text Colors

Customize text and background colors in your documents:

<Steps>
  <Step title="Open Color Settings">
    Navigate to **Settings → Workspace → Theme**
  </Step>

  <Step title="Customize Text Color">
    Click on **Document Text Color** to open the color picker
  </Step>

  <Step title="Set Custom Color">
    * Use the color wheel for visual selection
    * Enter a hex color value (e.g., `#FF5733`)
    * Adjust opacity level (0-100%)
  </Step>

  <Step title="Apply to Documents">
    Your custom color will be used for new text
  </Step>
</Steps>

### Cursor and Selection Colors

Personalize your editing experience with custom cursor and selection colors:

#### Custom Cursor Color

1. Go to **Settings → Workspace → Theme**
2. Click **Cursor Color**
3. Choose a color from the palette or enter a hex value
4. Your cursor will update immediately

#### Custom Selection Color

1. In the same Theme settings
2. Click **Selection Color**
3. Choose your preferred highlight color
4. Adjust opacity for subtle or bold highlighting

<Info>
  Custom cursor and selection colors help you personalize your editing environment and can improve visibility based on your preferences.
</Info>

### Color Picker Features

<CardGroup cols={2}>
  <Card title="Hex Values" icon="hashtag">
    Enter precise color codes (e.g., #FF6B6B)
  </Card>

  <Card title="Opacity Control" icon="droplet">
    Adjust transparency from 0-100%
  </Card>

  <Card title="Color Wheel" icon="circle-half-stroke">
    Visual color selection interface
  </Card>

  <Card title="Recent Colors" icon="clock-rotate-left">
    Quick access to recently used colors
  </Card>
</CardGroup>

## Font Customization

### Workspace Font

Change the default font family for your entire workspace:

<Steps>
  <Step title="Open Font Settings">
    Navigate to **Settings → Workspace → Workspace Font**
  </Step>

  <Step title="Browse Fonts">
    AppFlowy supports hundreds of Google Fonts:

    * System Default: Uses your OS default font
    * Google Fonts: Extensive library of web fonts
    * Custom Fonts: Upload your own fonts (advanced)
  </Step>

  <Step title="Select Font">
    Click on a font to preview it in your workspace
  </Step>

  <Step title="Apply Changes">
    The font updates across all documents immediately
  </Step>
</Steps>

### Popular Font Choices

* **Roboto**: Modern and readable
* **Open Sans**: Clean and professional
* **Lora**: Elegant serif for long-form content
* **Fira Code**: Perfect for code snippets
* **Inter**: Optimized for screen reading

<Note>
  Font selection affects the entire workspace but can be overridden per-document with inline formatting.
</Note>

### Font Size Scaling

Adjust text size for better readability:

1. Go to **Settings → Workspace**
2. Look for **Text Scale** or **Font Size**
3. Choose from:
   * **Small**: Compact view (0.7-0.8x)
   * **Medium**: Default size (1.0x)
   * **Large**: Enhanced readability (1.0x, but mobile supports up to 1.2x)

<Info>
  On mobile, you can scale the app's display size independently for optimal viewing on smaller screens.
</Info>

## Document Customization

### Page Width

Control the maximum width of your document content:

<Steps>
  <Step title="Open Document Settings">
    In any document, click **More (⋮)** → **Page Style**
  </Step>

  <Step title="Adjust Width">
    Use the slider or select from presets:

    * Narrow (600px)
    * Medium (800px)
    * Wide (1000px)
    * Full Width
  </Step>

  <Step title="Apply to Document">
    Changes affect the current document only
  </Step>
</Steps>

### Text Direction

Support for right-to-left (RTL) languages:

1. Navigate to **Settings → Workspace → Text Direction**
2. Select:
   * **Left-to-Right (LTR)**: For English, Spanish, Chinese, etc.
   * **Right-to-Left (RTL)**: For Arabic, Hebrew, Persian, etc.
3. RTL Toolbar Items: Toggle on to optimize toolbar for RTL languages

<Note>
  RTL support includes proper text alignment, toolbar positioning, and menu layouts.
</Note>

### Layout Direction

Control the overall UI layout direction:

* **LTR (Left-to-Right)**: Sidebar on the left, standard layout
* **RTL (Right-to-Left)**: Sidebar on the right, mirrored layout

## Regional Settings

### Date Format

Customize how dates are displayed throughout AppFlowy:

<Steps>
  <Step title="Open Date Settings">
    Go to **Settings → Workspace**
  </Step>

  <Step title="Select Date Format">
    Choose from multiple formats:

    * US: MM/DD/YYYY (03/09/2026)
    * UK: DD/MM/YYYY (09/03/2026)
    * ISO: YYYY-MM-DD (2026-03-09)
    * Friendly: Month DD, YYYY (March 09, 2026)
  </Step>

  <Step title="Sync Across Devices">
    Date format syncs across all devices under your account (since v0.9.8)
  </Step>
</Steps>

<Info>
  Date format affects date pickers, database date fields, and document timestamps.
</Info>

### Time Format

Set 12-hour or 24-hour time display:

* **12-hour**: 2:30 PM
* **24-hour**: 14:30

1. Navigate to **Settings → Workspace**
2. Find **Time Format** setting
3. Select your preference
4. Changes sync across devices

### Week Start Day

Customize which day starts the week in calendar views:

<Steps>
  <Step title="Access Calendar Settings">
    Go to **Settings → Workspace**
  </Step>

  <Step title="Set Week Start Day">
    Choose:

    * **Sunday**: North American standard
    * **Monday**: ISO standard, used in most of the world
  </Step>

  <Step title="Apply to Calendars">
    Affects all calendar views and date pickers
  </Step>
</Steps>

<Note>
  Week start day, date format, time format, and language settings all sync across devices since version 0.9.8.
</Note>

### Language

AppFlowy supports multiple languages:

<CardGroup cols={3}>
  <Card title="English" icon="globe">
    Full support
  </Card>

  <Card title="Spanish" icon="globe">
    Español
  </Card>

  <Card title="French" icon="globe">
    Français
  </Card>

  <Card title="German" icon="globe">
    Deutsch
  </Card>

  <Card title="Chinese" icon="globe">
    简体中文
  </Card>

  <Card title="Japanese" icon="globe">
    日本語
  </Card>

  <Card title="Italian" icon="globe">
    Italiano
  </Card>

  <Card title="Russian" icon="globe">
    Русский
  </Card>

  <Card title="More..." icon="ellipsis">
    25+ languages
  </Card>
</CardGroup>

#### Changing Language

1. Go to **Settings → Workspace**
2. Select **Language** from the dropdown
3. Choose your preferred language
4. Restart AppFlowy to apply changes (if required)

## Workspace Icons & Branding

### Workspace Icon

Customize your workspace with a unique icon:

<Steps>
  <Step title="Open Workspace Settings">
    Navigate to **Settings → Workspace**
  </Step>

  <Step title="Change Icon">
    Click on the current workspace icon
  </Step>

  <Step title="Select New Icon">
    Choose from:

    * Emoji icons
    * SVG uploads
    * Custom images
  </Step>

  <Step title="Save Changes">
    Your new icon appears in the sidebar and workspace switcher
  </Step>
</Steps>

<Warning>
  Workspace name and icon customization is not available for local/offline workspaces.
</Warning>

### Page Icons & Covers

Personalize individual pages:

* **Page Icon**: Add an emoji or custom icon to any page
* **Cover Image**: Add a banner image to documents
  * Upload custom images
  * Choose from Unsplash integration
  * Set solid colors as covers

## Advanced Customization

### Custom Themes

Create and upload your own themes:

<Steps>
  <Step title="Download Theme Template">
    Get the JSON theme template from AppFlowy's GitHub
  </Step>

  <Step title="Edit Theme File">
    Modify colors, fonts, and styling in the JSON file
  </Step>

  <Step title="Upload Theme">
    Go to **Settings → Workspace → Theme → Upload Custom Theme**
  </Step>

  <Step title="Apply Your Theme">
    Select your uploaded theme from the dropdown
  </Step>
</Steps>

<Info>
  Community themes are available on GitHub. Check out creations from other AppFlowy users!
</Info>

### Document Padding

Adjust the inner spacing of your documents:

1. Navigate to **Settings → Workspace → Theme**
2. Find **Document Padding** setting
3. Adjust the slider for more or less whitespace
4. Preview changes in real-time

## Shortcuts Customization

Customize keyboard shortcuts to match your workflow:

<Steps>
  <Step title="Open Shortcuts">
    Navigate to **Settings → Shortcuts**
  </Step>

  <Step title="Find Command">
    Browse or search for the command you want to customize
  </Step>

  <Step title="Set New Shortcut">
    Click on the shortcut and press your preferred key combination
  </Step>

  <Step title="Resolve Conflicts">
    AppFlowy will warn you if the shortcut is already in use
  </Step>
</Steps>

<Note>
  Access the shortcuts guide anytime by clicking the **?** button in the bottom-right corner of AppFlowy.
</Note>

## Sidebar Customization

### Sidebar Width

Resize the sidebar to your preference:

* Hover over the right edge of the sidebar
* Click and drag to resize
* Double-click the edge to reset to default width

### Collapsed Sidebar

Maximize content space:

1. Click the collapse button (◀) at the top of the sidebar
2. Sidebar automatically collapses when window is small
3. Setting persists across sessions

### Favorites Organization

Customize your favorites section:

* **Drag to reorder**: Click and drag favorite pages (since v0.8.1)
* **Group by space**: Organize favorites within spaces
* **Quick access**: Pin frequently used pages

## Database View Customization

### Custom Icons

Add icons to database views:

1. Open a database (Grid, Board, or Calendar)
2. Click on the view name at the top
3. Select **Add Icon**
4. Choose from emojis or upload custom images

### View-Specific Settings

Each database view can have independent settings:

* Filters and sorts
* Hidden columns
* Column widths
* Compact mode

<Info>
  Since v0.8.5, you can enable compact mode for Grid and Kanban views to display more data per screen.
</Info>

## Mobile Customization

### Mobile-Specific Settings

On iOS and Android:

* **Display Scaling**: Adjust app size for your screen
* **Page Style**: Customize layout, font, and font size per page
* **Dark Theme**: Improved dark mode experience (since v0.5.1)

### Mobile Widgets

<CardGroup cols={2}>
  <Card title="iOS Widgets" icon="apple">
    Quick Page Access, Recent Pages, Favorites
  </Card>

  <Card title="Android Widgets" icon="android">
    Recent Pages and Favorites widgets
  </Card>
</CardGroup>

## Troubleshooting Customization

<AccordionGroup>
  <Accordion title="Theme not applying">
    * Try restarting AppFlowy
    * Check if theme file is valid (for custom themes)
    * Reset to default theme and reapply
  </Accordion>

  <Accordion title="Custom font not showing">
    * Ensure font is installed on your system
    * Verify font name is spelled correctly
    * Try a different font to test
  </Accordion>

  <Accordion title="Settings not syncing">
    * Ensure you're using a cloud workspace (not local/offline)
    * Check your internet connection
    * Try logging out and back in
  </Accordion>

  <Accordion title="Custom colors look wrong">
    * Verify hex color codes are correct
    * Check opacity settings
    * Test in both light and dark modes
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Plugins" href="/advanced/plugins" icon="puzzle-piece">
    Extend AppFlowy with plugins and integrations
  </Card>

  <Card title="Vault Workspace" href="/advanced/vault-workspace" icon="vault">
    Create a private, offline workspace
  </Card>
</CardGroup>