Introduction - the golden copy concept
Library makes it easy to quickly find the current copy of company information. As a Librarian, you have ownership (perhaps shared with others) of a particular Library Volume.
Library is not intended to replace file shares or for "document collaboration". If you are working to create and refine a document, either by yourself or as a small team of people, Library is probably not the best place to keep your work-in-progress content.
Library is also not a place to fill up with messy archives of old files. Don't allow it to become a "dumping ground". Leave archives in your traditional file shares, which you can link to from your Library Volume. A great Library Volume is organized and curated so that people can find the current copy of what they need quickly.
Library is intended to be a go-to place for the reference information that employees need from time-to-time. A place where you can quickly find the current copy of forms, budgets, policies and the like. It solves the problem of searching in your file share for "budget" and finding 5 different files all marked something like "budget final". In Library, the budget is quick to find and for sure the final, reference version.
Library is intended to hold the golden copy of each key piece of information on your company.
Table of contents
- Your role as a Category Librarian
- Editing Categories
- Managing Volumes
- Your role as a Volume Librarian
- Creating Folders
- Uploading Documents
- Updating Documents
- Managing Documents with Google Drive
- Recommended Documents
- Using Links
- Organizing your Volume
- Downloading consumption data
- Exporting a Library Volume
- Moving a Library Volume to another Volume
- Editing thumbnails
1. Your role as a Category Librarian
After being assigned as a Librarian for a Category, Category Librarians can edit that Category, create and manage Volumes within that Category and assign Librarians to those Volumes.
As a Category Librarian, it is very important that you ensure each Volume is assigned a Librarian best suited to manage and maintain the content within that Volume.
2. Editing Categories
To edit a Category
- Click on LIBRARY in the Main Navigation.
- Go to the left navigation in Library and click the Category that you want to edit.
- Hover over the i-icon next to the Category name.
- On the i-menu, scroll down to Category Librarian actions and select your action (Edit Category Name, Edit Category Description or Manage Volumes)
3. Managing Volumes
To create a new Volume
- Go the to left navigation in Library and click on your Category.
- Click the “+” that appears to open the “Add new Volume” dialog
- Enter a name for your Volume and click the Save button
- The new Volume will appear at the top of your selected Category.
Adding/removing Volume Librarians
By default, Category Librarians are made Volume Librarians for any Volumes they create. To remove yourself and/or add additional Volume Librarians:
- Go to a Volume and hover over its i-icon.
- On the i-menu go down to Category Librarians Actions and select “Edit Volume Librarians”
- Use the List Selector to locate who you want to make a Volume Librarian (this can be an individual person, a Team, or a combination of both)
- To remove someone as a Volume Librarian, open the “Actions” menu that appears to the right of their name in the List Selector and select “Remove”.
Managing Volume Settings
In addition to assigning Volume Librarians, Category Librarians can do the following actions on Volumes in their Categories:
- Edit Visibility (viewing permissions)
- Block downloading
- Move to other Categories (of their own)
- Delete Volume
These actions can all be accessed from a Volume’s i-menu (see steps 1-2 above)
If a System Administrator deletes one of your Categories, then any Volumes that were contained within it will be moved to the Uncategorized Category. You can access your Volumes in Uncatergorized and move them to any of your other Categories via their i-menu action: "Move Volume to Category".
4. Your role as a Volume Librarian
The goal of a Librarian is to provide relevant, up to date and organized information. Library enables you to provide quick access to key documents, forms, links and videos with the people in your organization.
Your Library Volume was set up for a particular topic -- as a Volume Librarian you are expected to the subject matter expert on this topic. As a Volume owner, it is up to you to keep its content current and organized.
If you go to where your Volume appears in the Library left navigation and hover over the i-icon, the Volume’s i-menu will appear. This contains all the details of your Volume as well as the actions that can be taken on it by Volume Librarians. Actions that can be taken by the Category Librarian also appear there, but will not be enabled for Volume Librarians.
Volume Librarian Actions
The available actions for Volume Librarians are:
- Edit Volume Name
- Edit Volume Description
- Export Volume usage stats
- Download Volume to .zip
Note that the Visibility (viewing permissions) for each Volume is set by the Category Librarian. If a Volume indicates it has restricted visibility, clicking on that link will show exactly who has permission to view it.
6. Creating Folders
You can create whatever folder/file structure you deem appropriate for your Volume. Here's how:
- With your Volume open, click on Add New from the Action Bar at the top of the screen and select "New Folder".
2. Next, name your folder and click Create.
Note that new Library Volumes arrive with the first folder already activated and named "New folder". You can hover over this Folder to rename or delete it.
7. Uploading Documents
To upload a file to Library (non-Google users)
- Locate and click on the folder in Library where you want to add your document.
- Go to the Action Bar at the top of the screen and select Add New > Upload from computer.
- Select the file you wish to add to Library . Your upload will begin and you will see the below screen. (If the upload is a big one, you can click the Minimize icon at the top right and then work elsewhere in the platform while the upload proceeds).
- Once the upload is complete you can click on "Clear successful batches" to remove the upload screen.
TIP: If you wish to send a notification to everyone who has permission to view the file, just right-click over the item and select "Notify viewers of update" from the popover menu.
NOTE—the uploaded file (in Library ) is a copy of the original. The original version remains at its original location.
To upload multiple files
You can also upload multiple files at once using your browser's native multi-select capability (Note - IE 9 and below DO NOT support multi-select).
- Create and/or navigate to a folder in a Library Volume.
- Go to the Action Bar and select Add New > Upload from computer.
- Navigate to the folder that contains the files on your local computer and do one of the following actions:
- Press ctrl-a to select all the files in that folder.
- Click on a file, hold shift and click another file to select those two files and all files in between.
- Click on a file, hold ctrl and select other files to highlight multiple files individually
And then click Upload and all the selected files will upload.
TIP: You can also use drag-and-drop to copy multiple files or complete folders over from your hard drive right into a Library Volume (folders will retain any sub-folder structure as well).
- There is no upload size limit, but uploading very large files can be time consuming.
- Filenames should always contain a file extension that reflects the real format of the document.
Click here for a complete list of all file types supported by Jostle
8. Updating Documents
For Library to be effective, volumes must be kept up-to-date. Here are two options for how to update documents in Library:
If you have a master copy on your hard drive
- Make your updates to the master copy in your hard drive.
- Go to the copy of the document in LIBRARY and select "Upload updated version" from its popover menu.
- Select and upload your master copy from your hard drive.
NOTE - The uploaded document will overwrite all the content in the LIBRARY version except for the title.
If the LIBRARY copy is also your master copy
- Go to the document in Library and from its popover menu, select “Download”.
- Make updates to the downloaded copy on your hard drive.
- Go back to the Library copy's popover menu and select “Upload updated version”.
- Select and uploaded the updated copy from your hard drive.
About "Upload updated version"
When updating a document in Library , always use the "Upload updated version" feature from the popover menu. If you delete a document from Library and then replace it with an updated version, any links to the original document will be broken. But, if you update via "Upload updated version", then your Library document will:
- Retain any original links.
- Retain its original title (using "Upload updated version" will overwrite all the content of a document in Library except its title).
NOTE—you can notify viewers of updates by hovering over an item after if has been updated and selecting "Notify viewers of updates".
9. Managing Documents with Google Drive
Google Drive integration
If your Library is integrated with Google Drive:
- A Google Drive link will be added to the Action Bar
- A Google Drive sub-menu will appear on the “Add New” menu. From here you can copy existing items from your Google Drive to your Library Volume.
- You can also create new Google items (Docs, Sheets, Slides, or Forms) from the sub-menu that automatically save to your Volume once you title them (then just double-click on the newly-created item and it will open in a new browser tab, ready for editing).
- The Jostle LIBRARY folder will appear in your Google Drive > Shared with me folder (when logged in under your Jostle username). Visibility permissions set on any volumes in Library will remain intact in Google Drive.
- In addition to the methods available in the “Add New" menu, you can use drag-and-drop to upload files and folders directly to your Library Volumes (dragged-and-dropped folders will retain any sub-folder structures).
- There's no upload size limit in Library, however you must have enough personal space in your Google Drive for your files to be copied.
- Every document that gets added to your Jostle Library will be automatically added to your Google Drive > Shared with me > Jostle LIBRARY folder as well (including new Google items that you create in Library).
See this article for more information on Library /Google Drive integration.
If any Librarians want to edit a Google Doc that’s in their Library Volume, they can open their Volume and either:
- Hover over the document and select “View” from the popover menu
- Double-click on the document title
Either action will open the doc in Google Drive and any edits made will be reflected in real time in the Jostle Library as well as Google Drive.
This real-time editing and updating feature makes it easy for a group of collaborators to work on the same doc and not have to worry about multiple versions floating around or losing track of a document being passed from person to person for updates.
If you upload a doc from your personal Google Drive folders to your Jostle Library, you will now have two copies of the doc in your Google Drive: the one in your personal folder and the one in your Shared with me > Jostle LIBRARY folder.
Editing the doc in your personal folder will not update the doc in your Jostle Library, so to avoid potential confusion between the two versions here are two options:
- After importing your document from Google Drive, delete it from your personal folder, making the one in your Shared with me > Jostle LIBRARY folder the only one in your Google Drive. Edits can then be made directly to this version without the worry of potential confusion with your now-outdated original version.
- After importing your document from Google Drive, rename it in your personal folder (for example “Title_Original Version” or Title_Do Not Edit”) and move it to an Archive folder, so it will not get mistaken for the current version (in your Shared with me > Jostle LIBRARY folder).
- It's normally faster to use the "Upload from computer" option to select from your local copy of Google Drive, rather than using "Import from Google" and going to the cloud copy of Drive.
- You can use external Google Drive tools to sync your Library with your desktop. Here is how to install the Google Drive client for Mac/PC:
Retrieving Deleted Documents
If you mistakenly delete a document from a Volume, it will be permanently deleted from your Library. However, if it has been deleted for less than 30 days, your organization's Google Administrator should still be able to retrieve it as follows:
- Open Google Drive
- Click on the Account selector in the upper right corner and sign in as "jostle librarian"*
- Then click "Trash" on the left side of the screen
- Locate the deleted file, click it, and select "Restore"
This will restore the document to it's former location in Google Drive > Shared with me > Jostle Library, but not to your intranet LIBRARY (it will have to be re-copied there via the "Add New" link in the Library Action Bar).
*NOTE—If your jostle librarian account hasn't been configured yet, the Google Admin can go to Users > jostle librarian and select "Reset Password" to do so.
If your users encounter problems accessing files or actions in your Library, it may have to do with your Google Admin setup. For more information, refer here.
10. Recommended documents
Recommending key files in your Volume can help visitors quickly find the best document or video to start with. Here's how:
1. Right-click an item in Library and select "Recommend"
2. A red "R" will now appear under the Recommend column (alternatively, you can hover directly under the Recommend column and click on the greyed-out "R" to instantly Recommend an item)
3. In Tile view, the Recommend "R" will be a fixed visible feature, whether it's greyed-out or red.
To remove a Recommendation, right click over an item (or click the Action Menu icon to the right of the "R") and select "Undo recommendation".
11. Using links
You can create a Link object in any Library folder, which will open a web-based URL. To do this:
- Copy the URL (web address) for your link destination from your browser.
- Navigate to the folder you want to add the document to and hover over ADD ITEMS in the Action Bar.
- Click on New Link, which will open the modal screen show below.
- Paste the URL into the Web Address field.
- Type a clear name for your Link and click Create.
NOTE—if your Library is integrated with Google Drive, you can also:
- Add links to editable Google Docs
- Add links to any Google Forms (quizzes, order forms, etc)
However, it is not recommended that you link to files in your Google Drive as an alternative to importing copies of them to your Jostle LIBRARY. The contents of linked documents do not get indexed in Search, and will not show up as a match for any search made, no matter how relevant.
12. Organizing your volume
You can use the Organize function to move files within your Volume. Here's how:
1. Navigate to a folder and select the checkboxes next to file and/or folders you want to move.
2. Right-click over one of the selected items to pull up the Action Menu and select "Move".
3. This will take you to the Organize modal. Click on the folder you want to move the items to. It will highlight in color (orange in the example below).
4. Click on Move.
13. Downloading consumption data
Librarians can download data on how their files are being consumed, including the number of views and downloads, by clicking on Export Volume usage stats in the i-menu of their Volume.
Alternatively, if you click on the Filter icon in the action bar you will have the option to sort all the files in your volume according to views or downloads, which will help you to quickly see which documents are being accessed the most.
14. Exporting a Library Volume
Librarians can export the entire content of their Volume to a zip file by clicking on Download to Zip in the i-menu of their Volume.
15. Moving a Library Volume to another Volume
If you want to move the entire or partial contents of one Volume into another (the Organize function currently only works within a Volume), you will need to download and re-upload the files. Please note that you will also need to be the Librarian of the target Volume to be able to upload files to it. The following steps outline how to do this:
1. Navigate to the Library Volume that currently has the content.
2. Select the folders and files that need to be moved. Selected files will be highlighted in blue. Click to select/deselect a particular item.
3. Click Download in the Action Bar. The contents will be downloaded in a compressed zip file labelled 'libraryDownload.zip'.
4. Extract the contents from the zip file using your computers files system.
5. Navigate to the destination LIBRARY volume.
6. Click Add New > Upload from computer in the Action Bar.
Note: Folders cannot be uploaded at the moment (in the example below the Documents folder was not uploaded). To work around this limitation, create the folder structure you need in the new Volume before you start uploading files. By multi-selecting files you can batch upload per folder.
7. If you want, you can remove the content from the original Volume by selecting them and clicking Manage > Remove in the Action Bar.
16. Editing thumbnails
*This feature is currently being rolled out in a staged release*
Volume Librarians can edit the thumbnail image that appears next to any of their files, folders, or links. There is no size limit (larger images will be cropped) but browser limitations may cause issues when uploading larger files or certain image file types. To edit a thumbnail:
1. Right click over the item in your Volume
2. From the popover menu select "Info"
3. Under the default image, click Add thumbnail
4. Follow the onscreen prompts to add and adjust your image.
5. Then click Set image
6. After you have added your thumbnail image, you will now have the options to Change thumbnail and Remove thumbnail displayed on the info screen.