Sharing Folders or Gallery files
It is not possible to directly share a folder from the Workspace or the Gallery with other users. Instead, use RSpace Documents as the primary vehicle for sharing content. This makes sharing events more granular and easier to track in the audit trail. It also prevents accidental "over sharing" of large folder trees and prevents the creation of problematic "circular" sharing events. This article goes through various alternatives on how to achieve sharing a folder's contents. You might also be interested in the general documentation on collaboration and sharing.
Sharing items into a shared folder
When sharing with a group, you can share documents and notebooks into existing shared folders, or create a new shared subfolder during the sharing process.
- Follow the steps for sharing a document or notebook with a group in Sharing Content
- After selecting a group to share with, click on Change Folder

- Click on the arrows to the left of existing folders to tunnel down the group's shared folder hierarchy. Click on a folder to select it; you can also create subfolders directly from this view by clicking on the + icon to the right of a folder. Click on Select to confirm this folder as a destination for the shared items.

Using a document to share Gallery files
If you wish to share Gallery items, you can create a single RSpace document, and use it like a "container" or folder for any number of files you want to share or bundle together.
For example, you can add a list of files from the Gallery to a new document, then share it with a LabGroups or individual. Users the document was shared with will then be able to access all the files that are embedded in the document. This strategy offers a number of advantages and abilities:
- You or your lab can collectively decide who will own the document your shared files are listed in for better management of files.
- You can add annotations to each attached file to describe what they are and why they have been shared.
- You can create a convention for laying out shared files in an organized way, e.g. within an RSpace table with columns for required metadata.
- You can quickly see when files were added to that document by filtering for the document's unique ID in the audit trail.
- You can place documents containing shared files into a subfolder named something like "shared files" or you could make multiple subfolders for documents containign different types of files (e.g., "Images" , "Sequences", "Safety Sheets" etc.)
- You can share the same set of files (embedded in a document) with different LabGroups or individuals, without creating unnecessary duplicates.
- You can update the shared document and use the document revision history to access older versions of embedded files. You can also use the revision history and the audit trail to see who has read or edited content or added / removed embedded files in the past.
- You have more flexibility to describe the same files differently in different documents so that their signifigance is clear to whoever you share the document with.
Using links to folders in a document to organize and trace data
When you share resources in RSpace, you are not duplicating them, you are creating LINKS that let other people see and use them in other contexts. You can create links pointing to RSpace documents, notebooks and folders (using the internal link tool, or drag-and-drop from the left navigation tree).
The info section of RSpace folders and other resources help you see where those resources have been cited:

If other users you have shared a document with have appropriate permissions, they'll be able to access the linked content. This could be useful if you want to let users easily access relevant materials outside the current document. You can describe the links and explain why you are sharing them. This can be especially useful in a notebook, where you generally want to tell a succinct narrative story without inserting large blocks of verbose data. By referring to related data using links, you can keep your story concise and easy to follow for your readers, but still allow your audience to locate raw data or related resources that enhance the description of your experiments.