All posts

Troubleshooting Guide for AFFiNE Data Upgrade


We are currently in the process of migrating and upgrading our data systems. Acknowledging that upgrades can occasionally present challenges and result in various issues, such as data upgrade errors, we have prepared this article to assist you should you encounter the situation described below while using AFFiNE. This document addresses some of the concerns raised by our esteemed users during the recent AFFiNE upgrade. Please note that this is just a low-probability event. Our primary objective is to ensure a smooth transition for you and safeguard your valuable data.

STEP 1: Recover data through some basic and straightforward methods

1. Refresh through Command+R

If you encounter issues with pages or workspace not opening, try refreshing and patiently wait for the page to recover. This process may take some time, approximately 5 to 10 minutes. Kindly wait with patience.

2. Enable Cloud Workspace

Upgrade your local data to a cloud workspace to ensure automatic upgrades and synchronization between different versions.


STEP 2: Migrate the data from the latest version to the old version

The two basic methods may sometimes recover your data, but success is not guaranteed every time. If these two approaches do not resolve your issue, you can try the following steps:

1. Export data from the last AFFiNE client

First, you need to Export Workspace in the upgraded version. Navigate to "Workspace," select "Settings," scroll down, and click "Export." The exported workspace will be stored in the ".affine" format.

2. Download the old version of the client

Due to compatibility issues with the new version, we recommend downloading the previous version and re-importing your data. The recommended previous versions of AFFiNE can be downloaded from the following links:



3. Import previously exported data to the old version

After downloading and installing the preferred old version, you can re-import the data from the downloaded workspace. Select "Import" on the workspace list and choose the appropriate format for your data. Please note that the import format is ".affine".

4. Migrate the data to the latest version

However, if you wish to experience the latest version, we still recommend manually migrating your content to the web-based Cloud Workspace. You have the option to manually replicate the article content by copying and pasting it into Additionally, we highly recommend enabling the workspace to the cloud to ensure the preservation of data integrity and prevent any potential loss.

We're Here to Help

If the previously mentioned solutions do not address your concern, kindly reach out to us via email at [email protected] or engage with our community at to share your feedback.

If you would like to send your damaged workspace directly to the email address above, our developers will help you restore it manually and hopefully provide you with faster assistance. We value your cooperation and anticipate swiftly resolving your concerns.

Our sincerest apologies for any inconvenience caused by the recent update. We are dedicated to providing you with the best experience and are here to assist you every step of the way. If you have further questions or need personalized assistance, please do not hesitate to contact us through our community forum, Discord, or Telegram. Your feedback is invaluable to us, and we're always looking to improve.

Get more things done, your creativity isn't monotone

Explore on Desktop
Stars on GitHub