All posts



🤝 Welcome to the AFFiNE FAQ!

📚 Our aim is to help you navigate the user-friendly pathways and keep you updated.

📞 If you have any questions about using AFFiNE, don't hesitate to get in touch with us.

💡 We're here to assist you!

📢 By the way, the chance to become an early access user and explore AFFiNE Cloud is drawing to a close. Secure your spot now by making a payment through this link:

1) Install and Start

Q: How to install the latest AFFiNE client?

A: Official download link:

Q: What are the differences between the versions (Beta, Stable, and Canary)?


Beta: Ideal for testing upcoming features and providing feedback. Not suitable for production, as it's lightly tested.

Stable: The most reliable, well-tested version for a smooth experience without crashes or glitches. Usually released 1-2 weeks after beta.

Canary: Cutting-edge version with the latest features, released as soon as they're built, but untested.

Q: How should I choose which version to use?

A: We recommend that everyone who wants to explore and experience new features download the Canary version. If you want a more stable experience, please switch to the Stable version.

Q: Does AFFiNE offer a mobile app?

A: While acknowledging the importance of mobile applications, our current strategic emphasis is on desktop development to optimize resource utilization and enhance the user experience. Mobile app development remains a vital component of our long-term strategy, and it will be addressed in alignment with our broader goals and standards at a suitable time in the future.

Q: Can I access AFFiNE through a web browser?

A: Yes, you can access our web version at , but for a better experience, download our PC client. It offers stability, enhanced performance, and exclusive features for the best platform experience.

2) Create and Edit

Q: How to switch between Page and Edgeless pages?

A: By clicking the buttons located at the top of the interface, you can seamlessly transition between various features. This allows you to fully experience the robust capabilities encompassing writing, drawing, and panning all in one.


Q: How to establish a hierarchical note structure?

A: Presently, our system adopts a page/subpage structure, as depicted in the accompanying diagram, to facilitate a more transparent organization of data. Nonetheless, within our product development team, ongoing discussions are underway to explore additional enhancements for refining data structuring. We are planning to introduce incremental updates in the near future to implement these improvements. If you wish to create a subpage structure similar to the one illustrated, it can be achieved through the use of link pages.


Q: Is there an option for toggle/outline lists?

A: Unfortunately, the requested feature is not available at present. We appreciate its importance, but it is not yet available in the stable version. We request your patience as we work towards including it in future updates. The upcoming toggle will look like this:


Q: How can I delete multiple rows in the database?

A: To delete multiple rows in the database, drag and drop the rows you want to remove, then press 'ESC' followed by 'Backspace' to complete the deletion process efficiently.

Q: Can I input text inside a shape?

A: Sure! Add a shape on the whiteboard and double-click to input text. While resizing the shape, text won't automatically adjust, but you can manually modify font size and style.

3) Organize and Tags

Q: Does AFFiNE support filtering articles by tag?

A: Yes. You can click "All pages" and find the "filter" button on the upper left to filter your articles according to tags, collections or other rules.


Q: How to select multiple pages?

A: Activate the multiple selection feature by clicking the small checkbox adjacent to the title.


Q: How to change the layout width of page mode?

To modify the layout width, you can either press "Command+K" or utilize the search bar. Scroll down or type "layout" to locate the option, and then toggle to activate or deactivate the full width layout feature.


4) Share and Collaborate

Q: How can I share my page? Is it possible to share my page in edgeless mode?

A: Click on the "share" button in the top right corner and switch the mode you want to share.


5) Sync and Backup

Q: How to access AFFiNE cloud?


  1. Log in to Your Email: After becoming a sponsor, you will receive an email from the AFFiNE team confirming that your email address has been added to the whitelist. You can log in to AFFiNE with this email. Additionally, you have the option to sign in using your Google account.

  2. Create Your Cloud Workspace: You can create a local workspace and then enable it to a cloud workspace.


  1. Invite your collaborators: You can add user emails to the workspace and invite collaborators to work together.


Detailed Guidelines: For more detailed instructions or information about the new features or changes in the service, you can refer to the provided link:

Q: I have invited my collaborator, but why can't users join my cloud workspace?

A: Currently, Cloud has opened up free access to all users, allowing Free users of cloud workspace to have up to 3 collaborators. Pro users, on the other hand, will see an increase in the number of collaborators to 10 seats. If you encounter any issues while inviting collaborators, please reach out to us at

Q: Isn't the Docker image meant for self-hosting?

A: The Docker image is primarily designed for self-hosting, enabling users to run it on their own servers. Nevertheless, it is built to provide flexibility. Users have the option to configure it to integrate with cloud services if they find it necessary, depending on their specific needs.

Our server image aims at high scalability. It can be started in stand-alone mode without relying on any cloud service, or as a node in a cluster service. Therefore, the server contains the necessary cloud service components. Please refer to our self-hosting guide configures related components: Self-host AFFiNE.

Q: Is the underlying collaboration technology shared between self-hosting and cloud-based solutions?

A: Yes, the underlying collaboration technology is shared between self-hosting and cloud-based solutions. This ensures consistency in features and functionality across different deployment options. Please note that while local peer-to-peer (P2P) collaboration features may not have been developed yet, the core collaboration technology remains consistent across all deployment methods. We anticipate these improvements to be rolled out by the end of this year. We expect to support E2EE locally this year. Stay tuned for updates.

Q: Does AFFiNE provide support for end-to-end encryption?

A: AFFiNE's data synchronization is based on conflict-free replication data type (CRDT) technology, which is naturally compatible with end-to-end encryption (E2EE). CRDT also ensures that real-time collaboration is not hindered by geographical restrictions, network speed, and even offline use. AFFiNE gives priority to data security and hopes to promote seamless teamwork within the local network. We expect support for E2EE to be launched in the near future. Stay tuned for updates.

Q: Where is my page stored?



  • name string - You can request the following paths by the name:

    • home User's home directory.

    • appData Per-user application data directory, which by default points to:

      • %APPDATA% on Windows

      • $XDG_CONFIG_HOME or ~/.config on Linux

      • ~/Library/Application Support on macOS

    • userData The directory for storing your app's configuration files, whichby default is the appData directory appended with your app's name. Byconvention files storing user data should be written to this directory, andit is not recommended to write large files here because some environmentsmay backup this directory to cloud storage.

    • sessionData The directory for storing data generated by Session, suchas localStorage, cookies, disk cache, downloaded dictionaries, networkstate, devtools files. By default this points to userData. Chromium maywrite very large disk cache here, so if your app does not rely on browserstorage like localStorage or cookies to save user data, it is recommendedto set this directory to other locations to avoid polluting the userDatadirectory.

You might want to backup the whole userData folder. But still it does not ensure the backup will work in the future version. It is recommended to install the same version when you backup, upgrade to the latest version, and backup again.

6) Others

Q: Is it possible to build 3rd-party plugins now?

A: The plugin system is in early development, accessible exclusively within the Canary version. We are actively progressing with this feature and anticipate its availability by year-end. First-party plugins will be developed initially, followed by integration of GitHub and Figma plugins, scheduled for launch in January 2024. We also plan to introduce a stable API interface in the coming year, enabling users to create third-party plugins.

Q: What should I do if I want to delete my account and clear the account information?

A: Please send「delete account」requirement to [email protected] (need to include: confirmation of account information to be deleted/permission to delete account information, etc.).

Q: How to cancel the subscription?

  1. Open the AFFiNE app

  2. Click your name

  3. Click Account Settings

  4. Scroll to Subscriptions, then click Downgrade

  5. Find the Subscription that you want to cancel, then click Downgrade. If there is no downgrade button, the subscription has already been canceled


If the information provided above does not address your question, please feel free to reach out to us on our community forum, Discord, or Telegram. We look forward to receiving more of your feedback.

Get more things done, your creativity isn't monotone

Explore on Desktop
Stars on GitHub