This is an old revision of the document!


Changes in released versions of Zotero 5.0 are documented on this page. To follow development, see the commit log on GitHub. More recent changes may be available in a beta build.

Changes in 5.0.34.3 (January 22, 2017)

Zotero for Mac only

  • Fixes editing citations in footnotes in Word 2016 for Mac version 16

Changes in 5.0.34.2 (January 19, 2017)

Zotero for Mac only

  • Adds support for Word 2016 for Mac version 16

Changes in 5.0.34.1 (January 19, 2017)

Zotero for Mac only

  • Added warning regarding Word 2016 for Mac version 16 compatibility

Changes in 5.0.34 (January 11, 2018)

Functionality changed or added

  • The Word for Windows plugin is now digitally signed
    • This allows the plugin to be used at institutions that restrict the use of Office macros to known publishers.
  • Automatically rename dragged file attachments from parent metadata
  • Allow “now” in Accessed field to enter current time
  • Added “Publication” to top level of condition drop-down in Advanced Search window

Bugs fixed

  • Deleting a tag from the tag selector caused the tag to be deleted from all libraries
  • Undo in notes could restore changes from another note
  • Fixed inconsistent search results from word processor plugin in larger databases
  • Fixed issue where items list could disappear until restart when switching collections
  • When clicking away from a changed field in the item pane, the newly clicked field would close immediately
  • When editing a field on a newly created parent item, the opened field would close on auto-sync
  • “Unsupported predicate 'dc:isReplacedBy'” sync error

Changes in 5.0.33 (December 19, 2017)

  • Fixed display of toolbar in Word 2011 for Mac (since 5.0.31)
  • Fixed some UI issues with storage settings in Sync preferences

Changes in 5.0.32 (December 16, 2017)

  • Restore code signature (since 5.0.31)

Changes in 5.0.31 (December 15, 2017)

Note: Due to a packaging error, Zotero 5.0.31 did not include a code signature.

  • Reintroduced “Restore to Online Library” functionality
    • Allows efficiently overwriting an online library with data from a local library
    • Only necessary when restoring from a local database backup or overwriting changes in the online library made on another computer that haven't yet synced to the local computer
    • See Sync Reset Options for more information
  • Don't show note in right-hand pane when editing in separate window
    • Notes now display in only one location at a time, fixing a bug where the two notes could get out of sync and lose recent content
  • Fixed cursor resetting when typing in attachment note
  • Fixed auto-focusing of note in separate editing window
  • Avoid unnecessary sync upload attempts in some situations
  • Select text in search bar when using Edit → Find or shortcut key
  • Miscellaneous bibliographic output and word processor integration fixes
    • Updated citeproc-js to version 1.1.182
  • Link URLs and DOIs in HTML bibliographies
  • Fixed context-menu paste into Add Item by Identifier popup
  • Disable “Check Database Integrity” button while running
  • Show file path instead of “(null)” when installing style by launching a CSL file

Changes in 5.0.30 (December 3, 2017)

  • [Windows] Fixed “Access is denied” sync error with read-only files
  • [Windows] Clear read-only attribute when storing file
  • Fixed potential sync error after resetting read-only group
  • Show proper warning when trying to sync an attachment note containing embedded images
  • Don't show warning about Firefox profile access if 'zotero' subdirectory doesn't contain a Zotero database
  • Miscellaneous bibliographic output and word processor integration fixes
    • Updated citeproc-js to version 1.1.181
  • Fixed error saving from feed items when primary translator fails
  • Fixed sorting of creator types in non-English languages

Changes in 5.0.29 (November 28, 2017)

  • Fixed various issues in items list after editing items, including lost cursor position or text when editing a note
  • Fixed styling of LibreOffice footnotes (since 5.0.28)
  • Fixed extra auto-sync after uploading data

Changes in 5.0.28 (November 22, 2017)

  • Warn on duplicate Zotero for Firefox data directory immediately after 5.0 upgrade instead of on first restart
    • If separate databases exist for Zotero Standalone 4.0 and Zotero 4.0 for Firefox, Zotero 5.0 automatically uses the more recent database, which may not be the desired directory if Zotero for Firefox has the primary database but Zotero Standalone 4.0 is opened before the upgrade to Zotero 5.0. This dialog warns about that situation and allows switching to the Firefox database, but it previously didn't show until the next restart after a 5.0 upgrade.
  • Sped up LibreOffice citation inserts/edits
  • Fixed 'mimeType is undefined' sync error

Changes in 5.0.27 (November 17, 2017)

Changes in 5.0.26 (November 17, 2017)

  • Show warning on Firefox profile access error after installation
  • Don't ignore whitespace when sorting
    • This temporarily restores use of non-leading punctuation for sorting.
  • Fixed bug that caused database integrity check to miss some errors
  • Fixed 'fieldMode' cannot be 1 with 'firstName' property startup error
  • [Linux] Reduce spacing in collection pane

Changes in 5.0.25 (November 12, 2017)

Functionality changed or added

  • Add one-second delay before marking feed items as read
  • Miscellaneous bibliographic output and word processor integration fixes
    • Updated citeproc-js to version 1.1.180

Bugs fixed

  • [Mac] Don't try to open second copy of Zotero when launching via Spotlight/etc. or opening RIS file
  • Fixed extremely slow startup with some databases
  • Fixed date parsing from Atom feeds
  • Fixed feed item read/unread toggle shortcut
  • Fixed “Rename File from Parent Metadata” for linked file if target filename exists
  • Fixed potential error accessing missing old attachments created on a Mac from other OSes

Changes in 5.0.24 (October 30, 2017)

Functionality changed or added

  • Updated toolbar buttons on macOS
  • Updated additional low-res icons for high-res displays

Bugs fixed

  • Fixed various conflict resolution bugs
    • Choosing the local side for a conflict could fail to keep the local version
  • Properly stop background full-text indexing when computer becomes non-idle
  • Fixed items list problems when adding item with a search entered
  • Fixed “item._changed.creators is undefined” startup error
  • Fixed potential error after switching to first note of session
  • Fixed skipped group sync when another group is archived
  • Fall back to English sorting if system locale can't be parsed
  • Enable “Set Up Syncing” button when pasting via context menu or using drag and drop

Changes in 5.0.23 (October 14, 2017)

  • Fixed drag-and-drop unreliability (since 5.0.22)
  • Fixed warning about missing data directory on first run
  • Fixed item selection that required switching to the library root
  • Fixed incorrect 'et al.' behavior in Word for Windows plugin
  • Fixed rebuilding of full-text index
  • Save note on forward-delete when text is selected
  • Fixed a potential sync error
  • Fixed username displayed in warning when syncing an existing library to a different account

Changes in 5.0.22 (October 2, 2017)

  • Fixed various UI refresh bugs
  • Fixed various bugs importing RIS/BibTeX from the Connector
  • Fixed sync error due to invalid item relations
  • Set related items correctly when duplicating items
  • Fixed relations import from translators
  • Adjust font size in Create Bibliography window

Changes in 5.0.21 (September 21, 2017)

  • Fixed editing in classic citation window
  • Fixed sync error after deleting local collection containing remotely modified item
  • Miscellaneous bibliographic output and word processor integration fixes
    • Updated citeproc-js to version 1.1.178

Changes in 5.0.20 (September 20, 2017)

  • Fixed saved search deletion (since 5.0.19)
  • Close progress window on import error
  • Show better error for invalid security certificate during file sync

Changes in 5.0.19 (September 18, 2017)

  • Prevent further typing and require restart if an error occurs saving a note
  • Fixed error migrating from Zotero for Firefox due to corrupted Firefox preferences file
  • Fixed errors after using “Delete Collection and Items…”
  • Speed up emptying trash
  • Show better error message if data directory can't be created
  • Fixed startup error due to corrupted locate engine file
  • Fixed download of CrossRef locate engine icon

Changes in 5.0.18 (September 11, 2017)

  • Allow setting data directory via -datadir command-line flag
    • Pass an absolute path, or pass 'profile' to use a 'zotero' directory within the Zotero profile directory as in 4.0
    • Useful in situations where only the profile directory is writable by the user (e.g., an institutional roaming profile setup)
    • If Zotero is started without the command-line flag, it will revert to the previous location
  • Fixed intermittent item selection failure
  • Fixed restart error moving away from note that hadn't finished loading
  • Continue lookup process in Add Item by Identifier if an identifier isn't found
  • Fixed potential error relocating file with extended characters
  • Fixed potential error with full-text phrase search
  • Fixed “Create Bibliography” for saved searches
  • Fixed slow startup with many items in trash
  • Miscellaneous bibliographic output and word processor integration fixes
    • Updated citeproc-js to version 1.1.177

Changes in 5.0.17 (August 22, 2017)

  • Miscellaneous bibliographic output and word processor integration fixes
    • Updated citeproc-js to version 1.1.175

Changes in 5.0.16 (August 19, 2017)

  • Provide option at startup to switch to a recently updated Zotero for Firefox data directory, in case it was orphaned during data directory migration before 5.0.15

Changes in 5.0.15 (August 19, 2017)

  • Fixed data directory migration from Firefox profile directory

Changes in 5.0.14 (August 19, 2017)

  • Fixed error recognizing metadata for some PDFs (since 5.0.12)
  • Miscellaneous bibliographic output and word processor integration fixes
    • Updated citeproc-js to version 1.1.174

Changes in 5.0.13 (August 18, 2017)

  • Fixed handling of linked files when base directory is set to drive root

Changes in 5.0.12 (August 17, 2017)

Functionality changed or added

  • Restored Cut/Copy/Paste in note context menu

Bugs fixed

  • Show proper error messages for access-denied errors during file sync
  • Import intercepted RIS/BibTeX from connector into the selected collection
  • Fixed link opening in Add-ons pane
  • Fixed potential error updating citations
  • Fixed cleaning of passwords for some WebDAV errors from debug output

Changes in 5.0.11 (August 13, 2017)

Functionality changed or added

  • Download missing attachments as needed even in “at sync time” file sync mode
  • Show files remaining to download in sync button tooltip

Bugs fixed

  • Fixed first-run error with some upgrades
  • Fixed cases of files not being downloaded after interrupted syncs until files were changed remotely
  • Fixed handling of an error during Retrieve Metadata for PDF
  • [Mac] Fixed “Open in Library” from Quick Format popup if main window is closed

Changes in 5.0.10 (August 11, 2017)

  • Fixed opening of some links

Changes in 5.0.9 (August 10, 2017)

Functionality changed or added

  • When upgrading to 5.0 and a previous data directory is found for both Zotero Standalone and Zotero for Firefox, use the most recently opened directory
  • Show “Queued” for an attachment's full-text index status if synced full-text content is available but not yet processed

Bugs fixed

  • Faster shutdown speed when a file sync is in progress
  • Better handling of Unicode paths in WebDAV URL
  • Fixed opening of some links in the About window
  • Fixed a potential file sync error

Changes in 5.0.8 (August 5, 2017)

Functionality changed or added

  • Debug Output Logging improvements
    • A new menu under the Help menu allows for quickly generating and submitting debug output to Zotero developers
    • Debug output can now be displayed in real-time using the View Output option
  • [Mac] Allow Zotero window to be closed without quitting Zotero
    • Syncing, word processor integration, and saving from browsers will continue to work while the window is closed
  • Improve handling of data directory–related startup errors
    • If configured data directory is missing but data directory is found at default location (“Zotero” within the home directory), offer to use the default location instead
    • Provide better guidance when data directory is inaccessible
  • Update Quick Copy menu options based on current settings and URL
  • Don't include notes and attachments when generating bibliography via Quick Copy
  • Improve authenticated proxy detection at startup

Zotero Connector changes

  • The Zotero Connector for Firefox can now be used with more restrictive privacy/cookie settings

Bugs fixed

  • Trash didn't refresh properly when emptying deleted attachments
  • Auto-expand parent items to show search matches when viewing saved search
  • Fixed various problems when Zotero is started while Zotero is offline
  • Fixed external zotero:// links
  • Fixed various problems with Attachment Content search condition
  • Fixed crash switching from item Notes tab to feed item
  • Avoid unnecessary file access during full-text content syncing
  • Fixed “Copy as HTML” Quick Copy option (since 5.0.5)
  • Searching for “Presentation” attachment file type didn't find many PowerPoint files
  • Timeline fixes
    • Fixed error generating timeline with many items
    • Show item at beginning of month/year if date is incomplete
    • Fixed icons on high-res displays

Changes in 5.0.7 (July 24, 2017)

Functionality changed or added

  • User interface language switcher
    • Easily switch between supported languages from the Advanced pane of the preferences
    • Zotero will continue using the OS locale setting by default
  • Moved Style Editor and Style Preview to Cite preferences
  • Use HTTPS for Google Scholar lookup for Retrieve Metadata for PDF
  • Increased font size in word processor integration document preferences

Zotero Connector changes

These changes require version 5.0.11 of the Zotero Connector.

  • Follow the snapshot preference when saving webpage items to Zotero
  • Show a PDF icon for the save button when viewing a PDF

Bugs fixed

  • Fixed various issues related to data directory migration
  • Don't auto-sync groups that are deselected in “Libraries to Sync…”
  • [macOS] Fixed freezing in LibreOffice when attempting to display a dialog box
  • Fixed date handling for auto-detected locales
  • Fixed display of parent directory when locating missing file
  • Fixed rare issue with WebDAV syncing

Changes in 5.0.6 (July 20, 2017)

  • Fixed tag selector search (broken in 5.0.5)

Changes in 5.0.5 (July 20, 2017)

Functionality changed or added

  • Site-specific Quick Copy settings
    • Previously available only in Zotero for Firefox, now available in Zotero 5.0 for all browsers
    • Configurable in the Export pane of the Zotero preferences
    • Uses the URL of the last active tab in any browser running a Zotero Connector
  • Item tags box improvements
    • Improved performance when adding/removing tags
    • Added “Remove All Tags…” option to pane context menu to remove all tags from an item
  • Increased default window size to ~1000x600px
  • [Windows] Moved Tools → Options to Edit → Preferences
  • Restored Alignment menu with justification option in note editor context menu

Zotero Connector changes

These changes require version 5.0.10 or later of the Zotero Connector.

  • Restore proxy entries previously created in Zotero for Firefox
  • Show error message on save if collection selected in Zotero isn't editable

Bugs fixed

  • [Windows] Fixed tag selector font
  • Fixed ISBN lookup and PDF metadata retrieval for some ISBNs
  • Fixed excessive load during WebDAV syncing
  • Sort export translators in Quick Copy settings

Changes in 5.0.4 (July 14, 2017)

  • Fixed potential startup error
  • Fixed some collections-pane context-menu options (e.g., Sync)
  • [Mac] Closing Zotero in full-screen mode would leave window without title bar or toolbar
  • Prevent freeze when clicking on search with invalid Collection condition

Changes in 5.0.3 (July 13, 2017)

  • Fixed potential startup error
  • Fixed Windows menu key in items pane
  • Fixed selection issues in collections-pane context menu
  • Fixed blank window when opening ZotFile zotero://open-pdf links

Changes in 5.0.2 (July 12, 2017)

  • Fixed several sync errors
  • Fixed error removing files after unlinking account

Changes in 5.0.1 (July 11, 2017)

  • Fixed several sync errors
  • Fixed saving of reports

Changes in 5.0 (July 10, 2017)

Functionality changed or added

  • A Unified Zotero Experience
    • The two full versions of Zotero, Zotero for Firefox and Zotero Standalone, have been replaced by a single standalone application for users of all browsers. A new Zotero Connector for Firefox, similar to the extensions available for Chrome and Safari, allows you to save to the Zotero desktop application or zotero.org in a single click.
    • If you're a current Zotero for Firefox user, you'll be automatically upgraded to the Zotero Connector for Firefox, and you should install the Zotero application if you don't have it already.
    • See the announcement for more details on this change.
  • My Publications
    • Easily build a list of works — articles, papers, books, etc. — that you've created and share them on your profile page on zotero.org
    • Files can optionally be made publicly available to download under a license you specify
  • Feeds
    • Subscribe to RSS or Atom feeds — such as those made available by academic journals — from within Zotero
    • Browse new entries and add them to your Zotero libraries with a single click, with metadata and files automatically collected from the associated webpages
  • New syncing architecture
    • Selective library sync
      • Choose libraries to sync from the Sync pane of the preferences
      • Individual libraries can be synced on-demand via context menu
    • Independent syncing of libraries
      • Conflicts or other problems in one library no longer prevent other libraries from syncing
    • Improved handling of very large libraries
      • Data changes are now synced incrementally rather than in a single batch
    • Improved handling of sync conflicts
      • Many situations that previously resulted in conflicts are now automatically resolved without manual resolution
    • Immediate sync triggering on remote changes
    • Ability to interrupt syncing (previously only file syncing could be stopped)
    • Ability to unlink account and automatically remove local data
  • Improved UI responsiveness
    • Long operations (e.g. large syncs and imports) are now performed in the background, allowing Zotero to continue to be used
  • New stacked layout option for narrower screens
    • Moves item pane below items list
    • Configurable in the General pane of the preferences
  • Note editor improvements
    • Upgraded to TinyMCE 4 (4.5.2)
    • New flat theme
    • Search/replace within notes
    • URL autolinking
    • Increased default font size
    • New blockquote style
    • Support for non-English locales
  • Direct style installation
    • Styles can be installed from the Zotero Style Repository in a single click without leaving Zotero
  • Faster translator/style updating
    • If automatic update checking for translators and styles is enabled, Zotero will now receive updates — including site compatibility fixes — within a few minutes instead of 24 hours
  • New default data directory location
    • Files are now stored in a 'Zotero' directory in the user's home directory
    • A data directory in the previous default location within the Zotero or Firefox profile directory will be automatically moved to the new location
    • The new location allows PDFs and other files to be searched via Spotlight on macOS and restores the ability for PDFs to be annotated in-place via Preview on macOS Sierra
    • Future versions of Zotero will simplify the structure of the data directory for easier browsing from the filesystem
  • Added “Delete Automatic Tags in This Library…” option to tag selector menu
  • Allow file dragging to web targets (e.g., Gmail) and Linux filesystem
  • Advanced Search improvements
    • Simplified search condition drop-down in Advanced Search window
    • Saved searches now appear under “Collection” condition
  • Export character set selection changes
    • Show character set drop-down in export window by default
    • Show only “Unicode (UTF-8)”, “Unicode (UTF-8 without BOM)”, and “Western”
  • Added “Manage Styles…” links to Create Bibliography and Document Preferences windows
  • Automatically attempt to fetch citation style used in document if missing
    • If style is not from an official source, Zotero will prompt before fetching
  • The Actions (gear icon) menu has been removed from the toolbar, as all options are now available in menus
  • Resizing panes is now easier on macOS, with wider draggable areas for pane splitters
  • Miscellaneous bibliographic output and word processor integration fixes
    • Updated citeproc-js to version 1.1.171
  • Many smaller improvements and fixes

Zotero Connector changes

A number of new Zotero Connector features require Zotero 5.0:

  • Proxy support (including support for hyphen-based EZproxy servers)
  • CSL style installation
  • RIS/BibTeX interception
  • Improved attachment saving

Bugs fixed

  • Preserve rich-text formatting when editing citations
  • Fixed report printing
  • Fixed hanging indent for references dragged to Google Docs
  • Prevent DNS rebinding attack against connector server
  • Fixed parsing of non-English months when using a non-English locale
  • Edit menu options are properly localized
  • Many more!

Older Changes