Translations of this page:

Changes in 4.0.19 (March 21, 2014)

  • Fixed WebDAV syncing (since 4.0.18)
  • Fixed Date Modified of some attachment items being updated unnecessarily during syncing (since 4.0.18)
  • Added Lithuanian locale
  • Allow Unicode characters in Zotero username in Sync preferences

Changes in (March 19, 2014) was released for Zotero for Firefox only.

  • Fixed startup error on Windows when debug.log pref was enabled
  • Fixed harmless “Not well-formed” message in browser console

Changes in 4.0.18 (March 19, 2014)

Functionality changed or added

  • Much faster full-text indexing
  • “Retrieve Metadata from PDF” improvements
    • Google Scholar CAPTCHA support to prevent blocks
    • Increased accuracy
    • UI improvements
  • Open links from within notes
  • Automatic linking of web addresses in notes
  • Transform Text sentence-case conversion now capitalizes after :, ?, ! (details)

Bugs fixed

  • Fixed Zotero crash pasting in creator with certain leading whitespace
  • Fixed first item drag of session
  • Fixed “Attachment Content” “does not contain” advanced searches in “all” mode
  • Fixed error recovering from DB corruption if main DB doesn't exist
  • Fixed a rare cause of sync conflicts
  • Fixed parsing of PMCID in Extra field for citations
  • Show sync error rather than stalling sync for an intermittent Amazon error
  • Miscellaneous other fixes

Developer-specific changes/fixes

  • item.attachmentCharset now returns charset name, not ID
    • The item.attachmentCharset setter can still take either name or ID
  • [Zotero for Firefox] Log debug output to the Browser Console on Windows
    • Slower than real-time output on other platforms, but much faster than the Windows text console
  • Added “Save” button and “Near Note” position to CSL Preview

Changes in (December 18, 2013)

This version was released for Zotero for Firefox only.

  • Allow collapsed state of left pane to persist between restarts
  • Fixed compatibility with Firefox Aurora/Nightly on Windows
  • Fixed a bug where the Zotero pane would not close when opening Standalone
  • Fixed several other small issues

Changes in 4.0.17 (December 14, 2013)

Functionality changed or added

  • When renaming attachment files, keep file extension if not provided
  • New -zoterodebug command-line flag to display debug output in console
  • Clarified some button and message text

Bugs fixed

  • Fixed potential database corruption when switching between Zotero for Firefox and Standalone
  • Fixed file sync errors with passwords containing % + two hex digits
  • Refresh Unfiled Items view when items are added
  • Fixed brief freeze adding a non-matching item to a search
    • Adding an item to a view in which it doesn't appear will now cause the library root to be selected
  • Properly revert attachment renames if they fail
  • Newlines weren't showing up in Abstract/Extra fields
  • Fixed immediate closing of title field when adding an item to a collection
  • Miscellaneous bibliographic output and word processor integration fixes
    • Updated citeproc-js to version 1.0.517
  • Made Esc (or clicking X on Windows) cancel Rebuild/Clear Index
  • Restored pane close button in Firefox 28+
  • Signed included DLL files on Windows to avoid false positive malware reports from antivirus software

Changes in 4.0.16 (November 19, 2013)

  • Fixed a number of potential freezes and crashes related to full-text indexing/syncing
  • Improved indexing of words containing apostrophes
  • Miscellaneous bibliographic output fixes
    • Updated citeproc-js to version 1.0.508
  • Blacklisted Firefox character set warning in error reports

Changes in 4.0.15 (November 13, 2013)

  • Fixed row height in items list at larger font sizes
  • Fixed error merging items in unsynced libraries
  • Fixed “columns itemID, tagID are not unique” sync error
  • Fixed changing of import character set preference
  • Don't show incorrect SSL error message for other network errors
  • Show “Check for Update” button when opening Zotero database in incompatible older version

Changes in 4.0.14 (November 6, 2013)

  • Fixed dragging items from My Library to group library
  • Fixed error merging certain items
  • Don't try to upload full-text content in read-only libraries

Changes in 4.0.13 (November 5, 2013)

Functionality changed or added

  • Full-text content syncing
    • Syncing of full-text content to and other linked devices
    • Allows full-text searching via the web or on other devices without requiring the original file (e.g., when using on-demand file download)
    • Enabled by default; existing users will be prompted on first sync
    • Note: Enabling full-text syncing breaks local database compatibility with earlier Zotero versions. A backup of the database is placed in the Zotero data directory during the upgrade.
  • Ability to move (instead of copy) files into Zotero
    • Cmd-drag on OS X, Shift on Windows and Linux
    • Known issue: Due to Mozilla bugs, external file drags do not display proper cursor feedback on all platforms.
  • Journal abbreviation improvements
  • Support for authenticated PAC setups in Standalone
    • If necessary, Standalone will now prompt for the proxy username and password at startup.
  • Improved detection of PDFs with non-PDF content at beginning of file


  • Imported latest localizations from Transifex
  • Localized some additional strings

Bugs fixed

  • Fixed hanging during certain file imports
  • Fixed “Invalid sync state '4'” error during sync
  • Fixed functioning of colored tags in group libraries
  • Fixed merging of tags during sync conflict
  • Fixed library-access-denied error after dragging item from read-only group
  • Improved handling of errors when starting Standalone
  • Don't fail during file upload if file is still being downloaded
  • Show patents by issue date in timeline view
  • Fixed PDF tools prompt on preference window open if Search pane was not yet loaded
  • Fixed Quick Copy site editor window in preferences
  • Fixed “Open Documentation” button in WebDAV verification certificate error dialog
  • Improvements to COinS import/export
  • Fixed erroneous “req is not defined” message after WebDAV error
  • Fixed innocuous “itemProgress is not defined” error
  • Undo tree row spacing change in Firefox/XULRunner 25 on Windows
  • Various other issues

Developer-specific changes/fixes

  • Renamed Zotero.ID.getKey() to Zotero.Utilites.generateObjectKey()
  • Return multiple items from Zotero.Utilities.itemToServerJSON()
  • Read 200 bytes instead of 128 in Zotero.File.getSample()

Changes in 4.0.12 (August 9, 2013)

  • Fixed switching into and out of connector mode in Zotero for Firefox (since 4.0.11)

Changes in 4.0.11 (August 8, 2013)

  • Fixed a file sync error on Windows (since 4.0.10)

Changes in 4.0.10 (August 8, 2013)

Functionality changed or added

  • Use Ctrl-Shift for all shortcuts on Windows/Linux instead of Ctrl-Alt
  • Added Firefox-wide shortcut (Ctrl-Shift-S/Cmd-Shift-S) for “Save to Zotero”
  • Improved UI responsiveness
    • Avoid freezing the UI during file syncs in libraries with many attachments
    • Avoid freezing the UI during autocomplete searches
    • Avoid freezing the UI if linked files are on an inaccessible server and the attachments (blue dot) column is enabled
  • Selective checking for local file modifications during file syncing
    • On manual syncs and the first auto-sync of a session, check all files
    • During other auto-syncs, check only files previously modified or opened externally via Zotero (including Show File) within the last 3 hours
    • Every 3 hours, do a full check of all files, even during an auto-sync
    • This change should reduce disk usage (and potentially increase battery life on notebooks) for users using auto-sync with libraries with many synced attachments.
  • Allow creation of linked files via drag-and-drop
    • Ctrl-Shift-drag on Windows/Linux, Cmd-Option-drag on OS X
    • Known issue: Mouse cursor feedback works reliably only on Linux
  • Focus Title field when creating new item via toolbar menu or shortcut key
  • If a creator exists on an item but is a different creator type than the one being entered, show creator in autocomplete list
  • [Standalone, Linux/OS X] Warn if Zotero is run as root, and correct an issue that would later prevent starting as a standard user
  • [Standalone] Alter auto-update message if program directory isn't writeable
    • Avoid implying that Zotero should be run as super-user to correct problem, and advise fixing permissions on the Zotero program directory instead

Bugs fixed

  • Shortcut keys were broken on Windows and Linux (since 4.0.9)
  • [Standalone] Don't show Firefox-specific shortcut keys in preferences
  • Fixed error exporting linked HTML files
  • Fixed resetting of notes in external note window if user was typing during file syncing
  • Updated auto-update pref text to include styles
  • Updated RIS/Refer pref text to include BibTeX

Developer-specific changes/fixes

  • Added Zotero.Item.libraryKey, to return libraryID and key (“0/ABCD2345”)

Changes in (July 27, 2013) was released for Zotero Standalone for Windows only.

  • Fixed crashes on startup after updating on some systems

Changes in 4.0.9 (July 22, 2013)

Functionality changed or added

  • Added publication title to “Title, Creator, Year” search
  • Default to last-used item type when creating item via keyboard
  • Removed conflict with Cmd-Shift-A and third-party shortcuts
  • Ignore files in translators directory not ending in .js
  • Allow additional schemes when adding links by URI

Bugs fixed

  • Fixed note blanking/overwriting from notes with embedded images
  • Zotero File Storage quota warning wasn't appearing
  • Don't update Date Modified when syncing related items
  • Fixed sync error if there were no valid files in an attachment directory
  • Don't display snapshot or link-from-page context menu options in Standalone
  • Miscellaneous bibliographic output and word processor integration fixes
    • Quick Format dialog
      • Fixed drag and drop
      • Protect against pasting HTML-formatted text
    • Fixed error message when inserting a field in an unsupported location
    • Don't change capitalization of unabbeviated words in journal titles
    • Better handle empty (e.g., incompletely deleted) bibliographies
    • Fixed handling of multiple missing/corrupt citations when “No” is clicked
    • Updated citeproc-js to 1.0.471
  • Fixed functionality and styling of note pop-ups
  • Call Preferences “Preferences” in menu on all platforms
  • Fixed various incorrect click behaviors in Duplicate Items view
  • Add Item by Identifier textbox was truncated on second open
  • Refresh Quick Copy list when resetting styles or translators
  • Installed style list did not update properly when adding a style if the preferences window was open but the Styles pane had not yet been selected
  • Avoid unnecessary scrollbar in sync error panel
  • Fixed spacing around Reindex Item icon on Windows

Developer-specific changes/fixes

  • Prefer higher-priority translators even if they don't target the top frame
  • Look for x-www-form-urlencoded instead of x-www-urlencoded in connector endpoint
  • [Zotero for Firefox] The folders within the 'chrome' directory are no longer packed into a zotero.jar file, since the extension itself is now run from an unpacked XPI

Changes in 4.0.8 (May 2, 2013)

  • Fixed database upgrade error if a 4.0.7 database was run in 4.0-4.0.6 and then opened in 4.0.7

Changes in 4.0.7 (May 2, 2013)

Functionality changed or added

  • Improved import performance
  • Added a WebDAV verification step to ensure 404 on missing files
  • Added default values for some translator hidden prefs

Bugs fixed

  • [Standalone] Fixed compatibility with authenticated proxies
  • Fixed removal of groups during sync
    • Recently removed groups should disappear within a few days
  • UI didn't update when adding/removing colored tags in search modes
  • Fixed “Display character encoding on export” checkbox in prefs
  • Fixed file sync error with overly solicitous WebDAV servers (since 4.0.6)
  • Daily translator/style check didn't trigger immediately after startup
  • Fixed potential file sync errors in libraries without file editing access
  • Miscellaneous bibliographic output and word processor integration fixes
    • Updated citeproc-js to 1.0.460
  • Fixed “Delete reconciliation unimplemented for searches” sync error
  • Fixed error in console when no results from regexp search

Changes in 4.0.6 (April 22, 2013)

Functionality changed or added

  • Autocomplete for tags, fields, and creators is now limited to the current library
  • BibTeX files downloaded from websites are now imported automatically (if served as text/x-bibtex or application/x-bibtex)
  • Increased maximum note length in middle pane to 120 characters
  • Shift-Enter in creator field now uses existing creator type for new creator, like ”+” button

Bugs fixed

  • Fixed syncing of relative paths
    • Clear and reassign a base directory to trigger syncing of existing relative paths
  • Fixed file downloads on WebDAV servers that don't return a Last-Modified header (,
  • Changed WebDAV 'lastsync' files to 'lastsync.txt' for better server compatibility
  • Errors on some file sync requests could hang sync progress
  • Fixed UI update when adding/removing colored tags in search modes
  • Fixed attaching of files with very long filenames
  • Fixed saving of PDFs open in pdf.js
  • Favor top frame when saving from sites using frames
  • Fixed “attachments is undefined” save error
  • Download progress window never disappeared if the snapshot pref was disabled in Zotero Standalone
  • Improved parsing of attachment paths/filenames in RIS files
  • Allow ”%” character in attachment filenames
  • Fixed cut-off document preferences window on first use
  • Updated citeproc-js to 1.0.451
  • Fixed some styles (e.g., AGM SIG-CHI Proceedings) in RTF Scan

Developer-specific changes/fixes

  • Add about:memory button to Standalone

Changes in 4.0.5 (April 16, 2013)

Functionality changed or added

  • Added icons to context menus on Windows and Linux
  • Added automatic handling of renamed CSL files

Bugs fixed

  • Some file sync errors weren't being caught and displayed
  • Fixed “Source item for keyed source doesn't exist” sync error
  • Better handle some file sync file access errors
  • Don't deselect tags in tag selector unnecessarily
  • Colored tags weren't shown in collections with no other tags
  • Fixed syncing error when switching between Zotero File Storage and WebDAV
  • Display note title even if first line is just an opening HTML tag
  • Fixed <div> appearing in some notes instead of <p>
  • Fixed incorrect creator add/delete button behavior when removing an unsaved creator row
  • Fixed Attachment Content regexp search
  • Updated citeproc-js to 1.0.450

Developer-specific changes/fixes

  • Allow attachments to be saved using relative URLs

Changes in 4.0.4 (April 8, 2013)

  • Fixed lookup of <8-digit PMIDs
  • Fixed abbreviation of single word journal titles
  • Fixed “this.get(…).then is not a function” word processor integration error
  • Fixed tag-related sync error
  • Fixed character encoding (including window title) of Timeline view
  • Clarified error message for login manager access failure in Firefox

Changes in 4.0.3 (April 4, 2013)

  • Fixed repeated auto-syncing
  • Fixed automatic title abbreviation for new installs
  • Fixed formatting for bibliographies created via drag-and-drop or Quick Copy
  • Fixed saving of relative attachment paths with extended characters
  • Fixed various potential file sync errors
  • Fixed installation from disk of CSL files with byte order marks
  • Recognize container-title-short as journal abbreviation
  • Updated to citeproc-js 1.0.446
  • Fixed reference test pane
  • Avoid some warnings in Error Console

Changes in 4.0.2 (April 2, 2013)

4.0.2 was released for Zotero for Firefox only.

  • Fixed setting of relative attachment path

Changes in 4.0.1 (April 2, 2013)

  • Fixed tag colors window in Chinese locale
  • Fixed editor in word processor integration classic view
  • Fixed various issues involving edit bibliography dialog
  • Avoid false positives for metadata retrieval for PDFs containing many consecutive underscores
  • Updated citeproc-js to 1.0.443

Changes in 4.0 Final (Not yet released)

4.0 Final will be released only on the Mozilla Add-ons site.

  • Fixed appearance of preferences window in some locales

Changes in 4.0 Beta 2 (March 28, 2013)

Functionality changed or added

  • Use of journal abbreviations can now be configured on a per-document basis
    • Option moved from Zotero preferences to document preferences
    • Disabled by default for existing documents, but enabled by default for new documents
  • Default on-demand file download to off
  • Disable warning if opening snapshots with annotations/highlights in more than one window

Bugs fixed

  • Fixed WebDAV file purging
    • Deleted files are now purged from the WebDAV server at the end of every sync
    • Orphaned files are purged every 10 days
  • Miscellaneous bibliographic output and word processor integration fixes
    • Updated citeproc-js to 1.0.442
  • Fixed WebDAV file sync conflict error
  • Fixed a bug affecting proxy-by-port EZProxy connections
  • Clarified failed CSL validation error message

Developer-specific changes/fixes

  • New ConcurrentCaller object: run a fixed number of concurrent async functions

Changes in 4.0 Beta 1 (March 22, 2013)

Functionality changed or added

  • Firefox 20 compatibility
    • Firefox 17 or later is now required
  • Tag colors
    • Colors can be assigned to up to 6 colors per library by right-clicking on a tag in the tag selector
    • Tags with colors assigned will show up at the top of the tag selector and can be added to (and removed from) selected items by pressing the 1-6 keys on the keyboard
    • Assigned tags will show up as color swatches next to an item's title in the middle pane
    • Colors are synced to other computers
  • On-demand download support
    • Can choose to download files at sync time or automatically when opened
    • Once a file has been downloaded, new versions will be downloaded and uploaded at sync time
  • Relative path support for linked files
    • A base directory can be configured in the Advanced pane of the Zotero preferences
    • Linked file attachments stored within the base directory will be referenced using relative paths, allowing the files to be accessed on different computers as long as the file structure within the base directory remains the same
  • Automatic style updating for all installed styles
    • Zotero will check for style updates once a day
    • Currently limited to styles available in the Zotero Style Repository
  • Automatic journal abbreviation support
    • When enabled, journal abbreviations are used automatically when citing
    • Currently supports MEDLINE abbreviations
    • Disabled by default for old documents, but enabled by default for new documents; can be configured in document preferences
  • PDF metadata retrieval improvements
    • Look for ISBN numbers
    • Better prevention of Google Scholar lockouts
  • ”# of Attachments” column is now two separate columns
    • A blue dot now shows if an item has a file attachment; if the file doesn't exist locally (e.g., because of on-demand download), the blue dot is empty in the center
    • A separate column (off by default) now shows the number of child notes
  • Additional item fields are now available as columns in middle pane
  • Multiple-identifier lookup support in Add Item by Identifier
    • Pasting multiple lines of text converts the text field into a multi-line text box, as does Shift-Return/Enter
    • Shift-Enter/Shift-Return submits input in multi-line mode
  • Multiple newline-separated creators and tags can be added at once
    • Paste newline-separated list into creator or tag field
    • For tags, pasting a newline-separated list or pressing Shift-Enter/Shift-Return changes the input field into a multi-line text box; press Shift-Enter/Shift-Return to submit (not yet implemented for creators)
  • Tag entry box improvements
    • Tags can now be created/removed via the keyboard
    • Single-tag entry is much faster
  • Added “Delete Collection and Items” context-menu option for collections
  • Import from Clipboard now imports into the current collection instead of creating a new collection
  • Date parts indicator now matches order in entered date
  • Improved saving notifications
    • Show name of target library
    • Show attachment download status
  • Rewritten file-syncing architecture
    • File syncing now occurs separately for each library, so a file sync error (such as a storage quota error) in one library no longer interrupts file syncing in other libraries
    • More accurate progress meter
    • Download progress for individual files is now shown in the middle pane
  • Added additional field in Quick Format dialog showing the name of the library and providing a link to the item
  • Duplicate detection improvements
  • Updated various UI strings
  • Various performance improvements
  • Sorting changes
    • Don't sort Year column by full date
    • Sort by title after creator and date, if not primary sort (including for notes, which have neither a creator nor a date)
    • For secondary/tertiary sort, use Year instead of Date if Year column is present and Date column is not
    • Use Date Added rather than Date Modified for final fallback sort to preserve item position after edits
    • Sort empty titles last when title isn't primary sort
  • Validate CSL styles on installation
  • Support for parsing PMIDs and PMCIDs from Extra field for use in citation styles
    • Will allow creation of styles that include PubMed IDs or URLs
    • Format is “PMID: [number]” and “PMCID: [number]”
    • Extra field is already used by existing translators
    • This is a temporary measure until dedicated fields are available.
  • New context-menu option to swap creator first/last names
  • [Zotero for Firefox] Icon is now a proper add-on bar icon
    • Can be moved/removed via Firefox “Customize…” window as well as via Zotero prefs
    • The icon can be in the toolbar or in the add-on bar, but not both (since it is now the same button)
  • Only show annotation toolbar on pages that already have annotations
  • Quit rather than restart when changing data directory to allow for moving of data
  • Show startup errors in the alert itself
  • Don't shorten URLs in reports
  • The “Advanced” preference pane has been separated into two tabs, “General” and “Files and Folders”
  • Filenames are no longer Base64-encoded in ZIP files uploaded to WebDAV servers
  • [Zotero for Firefox] New -ZoteroPaneOpen command line argument to open Zotero pane automatically on Firefox startup


  • Imported latest localizations from Transifex
  • Localized most unlocalized strings
  • RTL support in notes
    • The note editor now defaults to the directionality of the current locale, with a button to toggle to the opposite direction

Bugs fixed

  • Fixed incorrect scrolling of middle pane after item edit
  • Fixed erratic window height in Preferences window
  • Miscellaneous bibliographic output and word processor integration fixes
    • Updated citeproc-js to 1.0.425
  • Focus preferences window if already showing
  • Improved handling of corrupt translator files
  • Fixed checkboxes in tag selector menu on OS X
  • Fixed error importing RDF files with very long notes
  • Escape special characters in file paths when attaching files
  • Don't update item when tabbing through empty Date field
  • Fixed saving of web pages with invalid characters at end of URL
  • Don't show open/save dialog when dragging certain text-based files (e.g., Python scripts) into Zotero
  • Various other issues

Developer-specific changes/fixes

  • The Q promises library is now available and used in various places
  • Added asynchronous versions of various functions that return Q promises
    • Zotero.HTTP.promise()
    • Zotero.File.getContentsAsync()
    • Zotero.File.putContentsAsync()
    • Zotero.File.getBinaryContentsAsync()
  • Allow web translators to monitor DOM nodes for changes in order to re-trigger detectWeb()

Older Changes

4.0_changelog.txt · Last modified: 2014/03/22 16:00 by dstillman