Quick Troubleshooting for iOS Syncing
Here are some quick things to check if you encounter syncing issues on the iOS version of Scrivener.
The first thing you'll want to do is ensure you have carefully followed the steps to set up Dropbox in Scrivener for iOS. In particular, you'll want to make sure you have linked the correct Dropbox folder in Scrivener for iOS (i.e., the folder that contains your projects). You will need to access your projects from that same Dropbox folder on all of your devices if you would like to sync changes between them.
To confirm that you have linked the proper Dropbox folder in Scrivener for iOS, navigate to the Projects list in Scrivener for iOS, then tap the Edit button in the header bar. Tap the gear button that appears in the footer bar, then tap Dropbox Settings. You should see the path to the current linked Dropbox folder. On your desktop, open up the Dropbox folder in your Finder or File Explorer and ensure your projects are stored in that same linked folder.
Open the Dropbox application on your iOS device and browse around the files in general. Do they match what you see in the Dropbox folder on your desktop computer? If not, you may be signed into a different Dropbox account on the two devices.
This is just a test to see if you are using the correct Dropbox account---don't try to open the Scrivener project from within the Dropbox application.
You must be running at least Scrivener 2.8 on Mac, and Scrivener 1.9.5 on Windows to sync projects with iOS.
Projects last saved in versions of Scrivener older than these will need to be updated using a more recent version of the software before they can be opened on the iOS client. If you are getting an "Invalid Project Format" error of any kind, it might mean that you need to open the project on the desktop so that it has a chance to update.
This feature, accessed in the desktop version via
File ▸ Sync ▸ with External Folder, is designed to be used to sync Scrivener with third party tools, such as other text editors. It has nothing to do with Scrivener for iOS.
To sync changes you've made in the project to Dropbox, all you need to do is close the project. So long as the project is stored in the same Dropbox folder that you configured Scrivener for iOS to use, the changes you've made will be downloaded to Scrivener for iOS as soon as you tap Sync on that device.
You must install the Dropbox client in order for the syncing process to work seamlessly. Doing so will create a Dropbox folder on your computer, so you can access your projects with ease.
Instead of uploading your Scrivener project to the Dropbox website, you'll want to simply move the project into your Dropbox folder on your computer, ensuring that it is in the same folder that you have linked in Scrivener for iOS (see Double-Check the Dropbox Set Up Steps above).
If you open the Dropbox app on your iOS device, you will see the project files, but you will not be able to access them. You can only access the projects by linking your Dropbox folder in Scrivener for iOS so that the projects become available from the Projects list within the app.
The Projects list in Scrivener for iOS is divided into two sections: the first is labelled "Dropbox" and the second is labelled "On My iPad" or "On My iPhone", depending on which device you're using. Projects created in the "On My iPad/iPhone" section will not be visible to other devices, as they are stored locally on your device's hard drive. To move a project into Dropbox, tap the Edit button at the top of the Projects list, then use the drag handles on the right side of each project to drag it under the "Dropbox" heading.
When you are viewing the Projects list in Scrivener for iOS, there should be a sync icon in the top-right corner of the screen. Tap this to ensure your projects are up-to-date with any changes you may have made on other devices.
Make sure you are not trying to sync/open a zipped copy of the project. The project file (or folder on Windows) must be placed in Dropbox in its normal, uncompressed state. If you cannot open it directly from Scrivener on your desktop computer, then Scrivener for iOS will not be able to open it either.
If you are finding that Scrivener is getting stuck on the "Syncing with Dropbox..." screen upon syncing, it's a good idea to clear the Dropbox cache. To do this, navigate to the iOS Settings app. Scroll down to Scrivener, then tap Reset Scrivener. Flip the switch for Clear Dropbox Sync Cache. Now quit and relaunch the Scrivener app, then tap the sync icon. As it syncs, Scrivener will check the local files against all files in the Dropbox folder rather than just those that have changed since last sync, which will hopefully clear up whatever was causing syncing to get stuck.
If you have been backing up your projects, then the best thing to do when you encounter data loss is to recover your work from a backup copy.
If you haven't been backing up your projects, be sure to have a look at our article on keeping iOS projects backed up.
An extensive guide to syncing with more troubleshooting information can be found in Dropbox Syncing with iOS.
If you are experiencing a crash with iOS, please send us a crash report.