Zotero is, at the most basic level, a reference manager. It is designed to store, manage, and cite bibliographic references, such as books and articles. In Zotero, each of these references constitutes an item. More broadly, Zotero is a powerful tool for collecting and organizing research information and sources.
IPBES has adopted Zotero so all experts must use Zotero:
To manage references
To add in-text citations as they write in word processors e.g. MS Word and Google Docs
To use Zotero and its functions and make importing items easy, you need to install:
The Zotero desktop app
The Zotero Connector for Chrome or Firefox – note that some experts have reported issues with Zotero on Safari.
Zotero should operate the same whether you are using Windows or macOS, although there may be slight differences in how the desktop app appears and how certain functions are accessed. Thus, the Zotero screenshots below may look slightly different from how the Zotero desktop app appears on a user’s screen. One difference is how to access the Zotero Preferences window to change or customize settings in the Zotero desktop app:
Windows, upper left corner: Click Edit > Preferences > Sync tab
macOS, upper left corner: Click Zotero > Preferences > Sync tab
https://www.zotero.org/support/quick_start_guide#how_do_i_install_zotero
https://www.zotero.org/support/quick_start_guide#how_do_i_open_zotero
Zotero can be opened from your operating system's dock or file manager like any other program
Go to www.zotero.org
Click “Log in” in the upper right corner and then “Register for a free account” (in blue font above the login fields)
You can update your email address and personal information once you are logged in.
During the development of an assessment, private groups will be created at the assessment or chapter level depending on the needs of the assessment. Private groups means that only experts who are invited to the group will be able to see the group’s page. The private groups are completely hidden from group searches. They are not shown on members’ public profile pages and will not appear in search engine results. File sharing will be made available to allow group members to access and share files in addition to references. Invitations to the groups are managed by the assessment technical support unit.
Relevant Zotero documentation: https://www.zotero.org/support/collections_and_tags
Zotero refers to a reference as an item; for example, when you add a reference to a Zotero library, you are an adding an item to that library.
Collection: A group or subgroup within a library that allows for hierarchical organization; a collection is like a folder on a computer and is represented by a folder icon. The same item can belong to multiple collections. An item can be imported directly into a collection or imported to the library and then added to a collection. Note that collections are not portable when copying items between different libraries. Collections are used to organize items belonging to a Zotero library.
Due to how Zotero permissions work, everyone has access to all the chapter collections. Please only work within your own chapter collection (and subcollections if applicable) and do not add or delete items from other chapters’ collections or subcollections
A tag is like hashtag or keyword and is used for more detailed characterization of an item than simply placing an item in a collection or subcollection. The number of tags that can be assigned to an item is unlimited. A library or collection can be filtered by a tag or a set of tags to show the items that have been assigned the selected tag(s). Note that tags are portable; if you copy an item from one library to another the item’s tag(s) will transfer along with the item.
Libraries, collections, subcollections, duplicates
Tags are displayed in the lower left corner
Items are displayed in the center panel:
Standard columns for the center panel are Title, Creator (i.e., the author of the reference), and attachment (paper clip icon)
To sort the center panel view: Click on the column heading to sort by that heading; for example, if you click on the “Title” column header, items will be arranged alphabetically by title; clicking the “Title” header again will sort the items in reverse alphabetical order
You can add additional columns to the center panel view by right clicking one of the column headers and selecting additional headers from the popup list; for example, you may wish to have a column for “Year” which displays the year the refence was published
Information for a given item is displayed in the right panel when you click on an item in the center panel.
Make sure you are sign in with the same email address that has been invited to an assessments library.
You need to be signed in on the Zotero client
Consider syncing only the libraries you use. This will minimize bandwidth requirements and improve the fludity of your work.
Go to preferences
Windows, upper left corner: Click Edit > Preferences > Sync tab
macOS, upper left corner: Click Zotero > Preferences > Sync tab
Click on Sync
Click on choose libraries
In addition to setting your library sync preferences, you should also configure preferences for file syncing. It is recommended to set the downloads to "as needed" as shown in the image below.
Open Zotero preferences and click on the General tab (gear icon):
Windows, upper left corner: Click Edit > Preferences > Sync tab
macOS, upper left corner: Click Zotero > Preferences > Sync tab
Under Miscellaneous, uncheck the box for “Automatically tag items with keywords and subject headings” (Figure 4)
In the Zotero Style Manager, click on the American Psychological Association 7th edition. If it is not in the list of styles, click the 'Get additional styles' button, then find the “American Psychological Association 7th edition” style and click ok.
The Zotero Connector is a very useful tool for adding items to Zotero as it allows you to import items directly into Zotero with one click while browsing the web.
Zotero recommends adding items via a web browser rather than adding them manually. When adding an item from the web, Zotero automatically extracts the item’s metadata and downloads the PDF if available. This reduces errors in the item information.
Make sure you installed the Zotero Connector
Make sure the Zotero desktop app is open
Complete your browser search for an item (i.e. reference)
When you find an item you want to add to your chapter collection, click on the link for the item to go to the item’s webpage – for example, if you search for a journal article, click on the link that takes you to the journal’s page for the article
Click the Zotero save button in the upper right corner of the browser screen, to the right of the address bar
The Zotero save button resemble different icon forms depending on the type of item the current webpage is displaying – for example, the save icon for a journal article is a lined sheet of paper and the save icon for a book is a blue book
A webpage can be saved even if Zotero does not recognize the information on it – the save icon will be a gray webpage
After you click the save button, a popup window will appear showing which Zotero collection the item is being saved to
Make sure you are saving to your chapter collection or a subcollection for your chapter within the Nexus Assessment library
If you want to save the item to a different collection or subcollection than the current selection, you can change the selection in the popup window (Figure 13)
Once you have the document open the Word desktop app, do the following to add a citation:
Open Zotero desktop app if it is not open already
In the Word document, place the cursor where you want to add the citation
Click on the Zotero tab in the ribbon at the top of the document
Click the “Add/Edit Citation” button in the Zotero ribbon
The first time you click the “Add/Edit Citation” button, the Zotero – Document Preferences window will pop-up; select the following options:
American Psychological Association (APA) 7th edition
Language: English (UK)
For Store Citations As, select Fields
You can select Automatically update citations; if you find that this slows down the citation process, you can deselect this option and click “Refresh” in the Zotero ribbon to manually update the citations
Click “OK”
You can also set the citation style and language in the Preferences window
To set the citation style, open the Preferences window > Cite tab > Styles tab > select American Psychological Association (APA) 7th edition
To set the language, open the Preferences window > Advance tab > select English (UK) in the Language field
Zotero uses Citation Style Language (CSL) to properly format citations in many different bibliographic styles. IPBES has adopted the American Psychological Association 7th edition style. To use this style:
For more information about tags, please see here: https://www.zotero.org/support/collections_and_tags
Tags for the library or collection currently displayed in the Zotero center pane are shown in the tag selector box in the lower left corner of the page (see Figure 3).
You can search the library’s tags by typing in the field at the bottom of the tag selector box. To return to seeing all tags in the library or collection, click the “X” to the right of the search field.
Note that some items may have tags automatically added upon import into Zotero. After you add an item to your chapter collection or subcollection, you can add tags to an item.
Click on the item in the center panel– a panel to the right will display the bibliographic information under the “Info” tab
Click the “Tags” tab in the right-hand panel – any tags currently applied to the item will be displayed
Click the “Add” button
Start typing the tag name in the field that appears – as you type, a list of matching existing tags will be displayed
Continue typing your own tag – press the Enter/Return key to apply the tag or select an existing tag from the list and press the Enter/Return key
Click on the item in the center panel– a panel to the right will display the bibliographic information under the “Info” tab
Click the “Tags” tab in the right-hand panel – any tags currently applied to the item will be displayed
Click the minus sign button (“-“) next to the tag you want to remove
To filter items in the current display by tag, click on the tag or tags you would like to filter by. The center pane will then display the times that the selected tag(s) apply to; in the tag selector box, tags not selected will be greyed out. Click on a tag again to deselect and remove the filter. To deselect all tags, click on the arrow next to the multi-colored squares at the bottom right of the tag selector box and then click “Deselect All” from the menu that appears.
You will need the Zotero Tag plug in for this (https://github.com/windingwind/zotero-tag)
Download the latest release (.xpi file) from the Releases Page Note If you're using Firefox as your browser, right click the xpi and select "Save As.."
In Zotero click "Tools" in the top menu bar and then click "Add-ons"
Go to the Extensions page and then click the gear icon in the top right.
Select Install Add-on from file.
Browse to where you downloaded the .xpi file and select it.
Restart Zotero, by clicking "restart now" in the extensions list where the plugin is now listed.
Once you have the plugin installed simply, right click any item in your collections to add/remove tags in batches
For more information about duplicate items, please see here: https://www.zotero.org/support/duplicate_detection
Given the number of nexus assessment authors, it is inevitable that the same item will be added to the same collection more than once or to multiple collections (i.e., multiple Zotero chapter folders). Thus, there will be duplicate items in the group library and possibly in a given collection or subcollection.
Click on the “Duplicate Items” collection in the left-hand panel under the Nexus Assessment library. The items Zotero thinks are duplicates will be displayed in the center panel. You may find it helpful to then sort the items by title. Note that Zotero finds duplicates within a library, not a collection.
If you decide to detect duplicates, always MERGE duplicates (see below) rather than deleting them. Merging retains all of the collections and tags associated with an item. Please do not delete a duplicate – this removes the item and its information and you may end up removing an item or an item’s information from a chapter other than your own.
To merge items in the “Duplicate Items” collection:
Select an item in the center pane
Zotero automatically co-selects the other items that it thinks are duplicates – all of the duplicates for the selected item will be highlighted in light blue
In the right pane, click the “Merge Items” button
If the information fields for the item do not match completely across the duplicates, you can:
Select one item to be the master item from the list at the top of the right pane
Select the version of mismatched fields to include using the icons to the right of each field
It is important to retain citation links in the final versions of documents.
Authors have different preferences for their choice in word processors. Many experts prefer to use Google Docs because it facilitates online collaboration and it is easy to use. The drafts and and final documents are however, reviewed in MS Word so it is important to convert documents between different processors carefully to retain citation links.
If you use the Zotero word processor plugin to add citations to your document and then open the document in another word processor, the Zotero citation links will be lost. To retain active Zotero citations when moving between programs, you can use the plugin to convert the document to a temporary format that can be safely transferred and then restore it in another supported word processor.
In Word, use File → Save As… to create a copy of the document as a .docx with a new filename (e.g., “My Document - Transfer.docx”).
Click Document Preferences in the Zotero plugin and select “Switch to a Different Word Processor…”.
After the document has been converted, save the changes (File → Save).
Use File → Open… from within a Google Doc to upload the file.
Select Refresh from the Zotero menu in the opened Google Doc to continue using the document.
In the Google Doc, use File → Make a Copy… to create a copy of the document.
In the new document, select “Switch word processors…” from the Zotero menu.
Select File → Download as → Microsoft Word (.docx) and save the converted file.
Open the downloaded file in Word and click Refresh in the Zotero plugin to continue using the document.
For more information please refer to https://www.zotero.org/support/kb/moving_documents_between_word_processors
To create a reference list based on the citations added to the document:
Place the cursor where you want to add the reference list
Click on the Zotero tab in the ribbon at the top of the document
Click the “Add/Edit Bibliography” button in the Zotero ribbon
The reference list is automatically added to the document
Some common issues when initially using Zotero:
Make sure you are logged in with the same email address that received the invitation to join a group.
There is no Zotero tab in the Microsoft Word ribbon
The Zotero Desktop Client is not open
The Zotero desktop app is not open – open the desktop app
There is a slight lag in the communication between Word and Zotero – try again
There is a Zotero open citation dialog box – try minimizing any open windows or applications to see if there is an open dialog box; if so, close the box
List of Zotero documentation: https://www.zotero.org/support/
Help and troubleshooting: https://www.zotero.org/support/getting_help
Frequently Asked Questions: https://www.zotero.org/support/frequently_asked_questions
Knowledge base: https://www.zotero.org/support/kb
Zotero Forums: https://forums.zotero.org/
The Zotero Forums are searchable and can be very helpful if you have a unique or strange issue that cannot be resolved by the more common troubleshooting options.
Please contact the assessment technical support unit if you have questions regarding getting files into the assessment/chapter library, organizing the assessment/chapter Library and taking notes, generating bibliographies,citations, and reports.
Zotero can add items automatically using their an ISBN number, Digital Object Identifier (DOI), or PubMed ID. This is done by clicking the Add Item by Identifier button () in the Zotero toolbar, typing in the ID number, and clicking OK. You can even paste or enter (press Shift+Enter for a larger box) a list of such identifiers at once
Items can be added manually by clicking the green New Item () button in the Zotero toolbar, then selecting the appropriate item type. Metadata can then be added by hand in the right-hand pane. Apart from the versatility this provides, it is important for adding primary documents.
The technical support units will be required to clean references stored in Zotero periodically. Experts will only have read only access when this is taking place
Experts are strongly encouraged to import references into Zotero using the Zotero web tool or by importing .ris and .bib files. Dragging of PDF files is discourgaged
File sharing through Zotero is possible. Preference should be on grey literature. DOI of other files will suffice.
To export an entire library, right-click on it in the Zotero collections pane and choose “Export Library…”, or select “Export Library…” from the “File” menu. To export an individual collection, right-click on it and choose “Export Collection…”. To export specific items, select them in the items list, right-click, and choose “Export Items…”.
When sharing items with another Zotero user, select Zotero RDF with files and notes for the most complete transfer.
Deleting multiple attachments requires the creation of a "Saved Search". This can be used for deleting notes or PDFs or anything that meets a specified criteria.
Do an advanced search for "Attachment FIle Type --is --- PDF"
Create a saved search
Navigate to the saved search and select all (ctrl+a or cmd+a on a mac) and the right-click on "move items to trash".
The saved search will also contain the items to which the PDFs are attached, select all will only select the attachments.
Please use this workflow when the assessment has been approved and there will be no further changes to the references included in the text.
Archive the entire library before you start making any changes. Refer to instructions above on "Archiving a library"
In the Zotero chapter library, select one entry that was used in the chapter and create a tag named "assessment-chapterX". It is recommended to have a unique tag for each chapter. This will allow the determination of where and how frequent citations are used.
The bottom left of your screen shows all the tags in your library. Right click on the "assessment-chapterX" tag you just created. Click "Assign color". A pop up window will appear, ensure that the position is selected as 1 and press "Set Color". Assign a color for each of the chapter tags you created in #2.
Now, go to this website: https://rintze.zelle.me/ref-extractor/. Select "Choose File" and navigate to the chapter file, and click open
Next, under the results section, press the "Select in Zotero button". Here you will see in which libraries the references are located. Select the chapter library which contains the references
Click "open Zotero" in the pop up window. Zotero should now open with all the citations used selected
Press 1 (or the number corresponding to the position of the tag as set in #3) . Now all used citations used in the chapter document are tagged
Simply go through all the entries not tagged and delete them from the library. You will be left with only the tagged references that were used in the document
Remove all tags created by automatically and by experts. you should start by deleting tags that were automatically created.
Once you have finalized the clean up of the library you should change the library settings to limit modifications. The library "Group Type" should then be made public.
Zotero plugins:
Search for DOI: https://github.com/bwiernik/zotero-shortdoi
Parse references from CSV: https://anystyle.io/
Search for DOI from citations: https://doi.crossref.org/simpleTextQuery