🤝 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: https://community.affine.pro/c/insider-general/.
1) Install and Start
Q: How to install the latest AFFiNE client?
A: Official download link: https://affine.pro/download
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 https://app.affine.pro/ , 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: When can users anticipate the availability of the free version of AFFiNE Cloud?
A: We are pleased to announce that the Professional edition of AFFiNE Cloud Services will be launching in November. Additionally, our free version of cloud services will also be introduced. If you wish to experience AFFiNE Cloud's services in advance, we cordially invite you to participate in our exclusive "Early Access Believer Program." You can find more information here: https://affine.pro/blog/affine-cloud-early-access. If you would like to become an Early Access Believer, you can sponsor us through this channel: https://community.affine.pro/c/insider-general/. If you have already purchased AFFiNE Cloud, please download version 0.9.0 Beta.
Q: How to access AFFiNE cloud?
- 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.
- Create Your Cloud Workspace: You can create a local workspace and then enable it to a cloud workspace.
- 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: https://affine.pro/blog/what-is-new-affine-0922
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 https://community.affine.pro/home.
Q: Isn't the Docker image meant for self-hosting? Why is that dependent on the cloud?
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. Regardless of whether you choose to utilize cloud services or host locally, deploying the architecture remains an essential step.
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.
Q: Does AFFiNE provide support for end-to-end encryption?
A: Certainly, AFFiNE extends robust support for end-to-end encryption (E2EE). Our platform prioritizes data security while fostering seamless teamwork within local networks. With AFFiNE, you can confidently leverage E2EE alongside local area network (LAN) collaboration. Moreover, our collaboration framework, based on Conflict-free Replicated Data Types (CRDTs), ensures that real-time collaboration remains unhindered by geographical constraints, network speeds, and even offline usage. We anticipate these improvements to be rolled out by the end of this year.
Q: Where is my page stored?
namestring - You can request the following paths by the name:
homeUser's home directory.
appDataPer-user application data directory, which by default points to:
~/Library/Application Supporton macOS
userDataThe directory for storing your app's configuration files, whichby default is the
appDatadirectory 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.
sessionDataThe 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
userDatafolder. 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.
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.
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.