Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
zotero_data [2018/06/15 15:31]
dstillman [Locating Your Zotero Data]
zotero_data [2019/01/14 20:21] (current)
dstillman [Troubleshooting Zotero Data issues]
Line 3: Line 3:
 ===== Locating Your Zotero Data ===== ===== Locating Your Zotero Data =====
  
-The easiest and most reliable way to find your Zotero data is by clicking the "Show Data Directory"​ button in the [[preferences/​advanced|Advanced]] tab of your Zotero [[preferences|Preferences]] window.+The easiest and most reliable way to find your Zotero data is by clicking the "Show Data Directory"​ button in the [[preferences/​advanced|Advanced]] tab of your Zotero [[preferences|Preferences]] window. This will reveal the folder on your computer that contains your Zotero database and attachment files.
  
 ==== Default Locations ==== ==== Default Locations ====
Line 33: Line 33:
 ===== Library Contents ===== ===== Library Contents =====
  
-The most important file in the '​zotero' ​directory is the zotero.sqlite file, which contains the majority of your data: item metadata, notes, tags, etc. The directory also contains a '​storage'​ subdirectory,​ containing all of your file attachments,​ such as PDFs, web snapshots, audio files, or any other files you have imported (note that files that are [[attaching_files|linked]] are not copied into this subdirectory).+The most important file in the data directory is the zotero.sqlite file, which contains the majority of your data: item metadata, notes, tags, etc. The directory also contains a '​storage'​ subdirectory,​ containing all of your file attachments,​ such as PDFs, web snapshots, audio files, or any other files you have imported (note that files that are [[attaching_files|linked]] are not copied into this subdirectory).
  
 Your '​zotero'​ directory will likely contain several other files. These can include zotero.sqlite.bak (an automatic backup of zotero.sqlite,​ which is updated when you quit Zotero and the existing zotero.sqlite.bak file hasn't been updated in the last 12 hours) and zotero.sqlite.[number].bak files (automatic backups of zotero.sqlite that are created during certain Zotero updates). Your '​zotero'​ directory will likely contain several other files. These can include zotero.sqlite.bak (an automatic backup of zotero.sqlite,​ which is updated when you quit Zotero and the existing zotero.sqlite.bak file hasn't been updated in the last 12 hours) and zotero.sqlite.[number].bak files (automatic backups of zotero.sqlite that are created during certain Zotero updates).
Line 69: Line 69:
 If you were not using Zotero syncing (or were but don't want to perform a full sync) and have a backup of your Zotero data directory, you can restore your library by replacing your active data directory with your backed-up data directory. If you were not using Zotero syncing (or were but don't want to perform a full sync) and have a backup of your Zotero data directory, you can restore your library by replacing your active data directory with your backed-up data directory.
  
-Open the Advanced pane of the Zotero preferences and make a note of the specified path under Data Directory Location. (By default, this will be "​Zotero"​ within your home directory.) Click "Show Data Directory",​ which should reveal your active data directory containing zotero.sqlite and possibly a '​storage'​ subdirectory. Close Zotero, move one level up in the filesystem (Cmd-up-arrow on macOS, Alt-up-arrow on Windows), and rename the directory to "​Zotero-Old"​. Next, copy the data directory from your backup to the original location.+Open the Advanced pane of the Zotero preferences and make a note of the specified path under Data Directory Location. (By default, this will be "​Zotero"​ within your home directory.) Click "Show Data Directory",​ which should reveal your active data directory containing zotero.sqlite and possibly a '​storage'​ subdirectory. Close Zotero, move one level up in the filesystem (Cmd-up-arrow on macOS, Alt-up-arrow on Windows), and rename the directory to "​Zotero-Old"​. Next, copy the data directory from your backup to the original location ​(e.g., "​Zotero"​).
  
 When you reopen Zotero, you should see your restored Zotero data. When you reopen Zotero, you should see your restored Zotero data.
Line 85: Line 85:
   - Once you see your restored data, were you to sync again, the more recent data in the online library would replace the data you just restored.   - Once you see your restored data, were you to sync again, the more recent data in the online library would replace the data you just restored.
     - If you're trying to restore a small number of deleted items or notes, you can simply duplicate the items — by right-clicking and choosing "​Duplicate Item(s)"​ — so that the new copies remain even after syncing.     - If you're trying to restore a small number of deleted items or notes, you can simply duplicate the items — by right-clicking and choosing "​Duplicate Item(s)"​ — so that the new copies remain even after syncing.
 +    - If you're trying to restore deleted collections,​ you can create duplicate collections and drag items from the old collections to the new ones. When you sync, the old collections will be deleted but the new ones will remain.
     - If many items were affected or collections were deleted, you can use [[kb:​sync_reset_options#​restore_to_online_library|Restore to Online Library]] to force Zotero to upload the local version of the library, overwriting previously synced changes.     - If many items were affected or collections were deleted, you can use [[kb:​sync_reset_options#​restore_to_online_library|Restore to Online Library]] to force Zotero to upload the local version of the library, overwriting previously synced changes.
  
Line 103: Line 104:
   - Were you to sync again now, the more recent data in the online library would replace the data you just restored.   - Were you to sync again now, the more recent data in the online library would replace the data you just restored.
     - If you're trying to restore a small number of deleted items or notes, you can simply duplicate the items — by right-clicking and choosing "​Duplicate Item(s)"​ — so that the new copies remain even after syncing.     - If you're trying to restore a small number of deleted items or notes, you can simply duplicate the items — by right-clicking and choosing "​Duplicate Item(s)"​ — so that the new copies remain even after syncing.
 +    - If you're trying to restore deleted collections,​ you can create duplicate collections and drag items from the old collections to the new ones. When you sync, the old collections will be deleted but the new ones will remain.
     - If many items were affected or collections were deleted, you can use [[kb:​sync_reset_options#​restore_to_online_library|Restore to Online Library]] to force Zotero to upload the local version of the library, overwriting previously synced changes.     - If many items were affected or collections were deleted, you can use [[kb:​sync_reset_options#​restore_to_online_library|Restore to Online Library]] to force Zotero to upload the local version of the library, overwriting previously synced changes.
  
Line 124: Line 126:
 If you open Zotero to find your library blank or missing lots of data, don't panic. Zotero is mostly likely simply looking in the wrong location for the data. You need to make sure that Zotero is looking in the right location for your Zotero files and that the right files are in that spot. If you open Zotero to find your library blank or missing lots of data, don't panic. Zotero is mostly likely simply looking in the wrong location for the data. You need to make sure that Zotero is looking in the right location for your Zotero files and that the right files are in that spot.
  
-Use the "Show Data Directory"​ button in the [[preferences/​advanced|Advanced]] pane of the Zotero preferences to reveal the current data directory. If this isn't the directory you were expecting, you can either specify a different data directory from the preferences or, with Zotero closed, rename that directory (e.g., to "​Zotero-Old"​) and move your desired Zotero directory to the specified location. If you're not sure where your most recent Zotero data is located, it's a good idea to look for larger versions of zotero.sqlite or zotero.sqlite.bak stored elsewhere on your hard drive and to look at the dates of folders within the '​storage'​ directory.+Use the "Show Data Directory"​ button in the [[preferences/​advanced|Advanced]] pane of the Zotero preferences to reveal the current data directory. If this isn't the directory you were expecting, you can either specify a different data directory from the preferences or, with Zotero closed, rename that directory (e.g., to "​Zotero-Old"​) and move your desired Zotero directory to the specified location. If you're not sure where your most recent Zotero data is located, it's a good idea to look for larger versions of zotero.sqlite or zotero.sqlite.bak stored elsewhere on your hard drive and to look at the dates of folders within the '​storage'​ directory. An empty Zotero database will be either approximately 1 MB (~1,000 KB) or 5 MB.
  
 If you have recently updated to Zotero 5 and are missing data, see [[kb/​data_missing_after_zotero_5_upgrade|Missing Data After Zotero 5 Upgrade]]. If you have recently updated to Zotero 5 and are missing data, see [[kb/​data_missing_after_zotero_5_upgrade|Missing Data After Zotero 5 Upgrade]].
  
-Unless you have a good reason to use a custom data directory location, we recommend using the default location in your home directory.+Unless you have a good reason to use a custom data directory location, we recommend using the [[#​default_locations|default location]] in your home directory.
  
 When specifying a custom data directory location, keep in mind that Zotero doesn'​t move or copy any data. You still need to copy your data into the specified location. Also, when pointing the data directory location to an existing directory, be sure to specify the parent directory containing zotero.sqlite and '​storage',​ not the '​storage'​ directory itself. When specifying a custom data directory location, keep in mind that Zotero doesn'​t move or copy any data. You still need to copy your data into the specified location. Also, when pointing the data directory location to an existing directory, be sure to specify the parent directory containing zotero.sqlite and '​storage',​ not the '​storage'​ directory itself.
  
 Finally, remember to close Zotero before making any changes to Zotero files. Finally, remember to close Zotero before making any changes to Zotero files.
zotero_data.1529091101.txt.gz · Last modified: 2018/06/15 15:31 by dstillman