Use NoteGen Official Sync
Sign in to the beta service, review what will sync, and set up a second device.
NoteGen Official Sync keeps workspace files and selected personal data, such as records and conversations, in sync across desktop, iOS, and Android. This guide applies to client versions that show NoteGen Sync → Official Sync (Beta). Back up existing data outside your workspace before enabling the beta. On desktop, you can create a snapshot under Settings → Backup & Restore. See the beta service details for access, data retention, and key management.
Sign in and choose what to sync
- In Settings → Sync, select NoteGen Sync → Official Sync (Beta). On mobile, open settings from Me. You can also choose the same service during first-run setup.
- Read the experimental-feature notice and select Sign in with browser. Use your NoteGen Sync account to approve the device in your browser, then return to the app. You can also enter your account and password in the app, with a two-factor code when prompted. If you need an account, open the account page to check the current registration options.
- In Finish sync setup, check the target account and local folder, then review Cloud workspace for first sync. To access existing notes, select the cloud workspace that contains them. If the app proposes creating a workspace after confirmation, check that you want a new one.
- Expand Personal data and choose what to sync. You can select tags, records with linked notes and canvases, conversations, messages, memories, preferences, and personal attachments separately. Turning off tags pauses dependent records, linked notes, canvases, and messages. Turning off conversations pauses messages.
- Select Review data differences to continue. Set up later leaves this connection pending. Select Continue setup in Sync settings to return to this step.
Review differences and enable sync
Check the account, the destination cloud workspace, and the differences in files and personal data. Select Next: review changes. The confirmation button depends on which side has content in the current sync scope. Preferences and the default locked tag are excluded from this check.
| Local and cloud content | Confirmation button |
|---|---|
| Local content only | Upload local content and enable sync |
| Cloud content only | Download content and enable sync |
| Content on both sides | Merge content and enable sync |
| Neither side has content | Enable two-way sync |
Official Sync merges content unique to either side. For Markdown notes at the same path, NoteGen tries to merge the notes and keeps a conflict copy if it cannot. Updates and deletions follow sync versions. Use Change sync scope to correct the cloud workspace or personal data options. If the account is wrong, return to Sync settings, discard the pending connection, and sign in with the correct account.
After you confirm, NoteGen saves and verifies a local snapshot before syncing and checking the result. Once sync is enabled, changes sync automatically while connected. Offline edits are saved on your device and sync when it reconnects.
Set up a second device
- Wait for the first device to finish syncing, then check the name of the target cloud workspace. Back up any existing data on the second device.
- Sign in to Official Sync (Beta) with the same account, choose the same cloud workspace, and review the personal data options for this device.
- Review the differences and confirm. The download action appears when only the cloud has content in the current sync scope. If both sides have content, check the merge scope, especially files at the same path and existing records.
- Open a few synced notes and attachments, then check the personal data you enabled. Use Manage devices under Sync settings to see linked devices.
Sync scope and recovery
Workspace Markdown and attachments sync through the linked cloud workspace. Personal attachment sync covers resources managed by NoteGen, so back up external files separately. In Official Sync, Preferences covers a limited set of editor, outline, record display, and canvas options. API keys, tokens, local paths, and local indexes stay on the device. The account service stores device authorizations and encrypted sync content. In the default managed-key mode, the server can recover the content keys. See Privacy and data.
If sync fails, check its status and retry. Resolve note conflicts in the editor. Other saved copies are available in NoteGen Sync → Conflict recovery records. If first-time setup or switching fails and the window offers Restore data from before the switch, use it to restore the local snapshot and switch back to local storage. Recovered notes and attachments go into a separate folder. Any changes already made on the server remain in effect.