Skip to content

Collaborating in Datameer#

Inside a Project every user has basic permissions to view the detail page and make or reply to comments.

To enable more direct collaboration, the Project's owner can decide to add other users as collaborators who share many of the owner's capabilities to edit and expand the Project.

User permissions

User permissions#

Everyone in Datameer can:

  • See the Workspace details page
  • Comment on a Workspace or reply to comments

Collaborators can also:

  • Load the attached Workbench tool
  • Add or remove references in the Workspace
  • Create, edit, and delete new datasets in the in the Workbench
  • Edit the Workspace description, tags, and properties
  • Add or remove other collaborators

Owners can also:

  • Delete the Workspace
  • Change the owner

Administrators have the same permissions as owners for every Workspace, even if they do not appear in the list of collaborators.*

Security: Datameer defers to the access controls established on source data systems. Each user will need to authenticate with all the appropriate source systems using their individual credentials. Being a collaborator in a Workspace does not allow users to reuse each other's credentials.

View collaborators

View collaborators#

The Collaborators section lists the owner and all Datameer users who collaborate on the Workspace. The owner's icon is in the top left, separated from any other collaborator icons with a thin bar. Hover over an icon to see the person's full username. Click the 'plus' button button to open the manage collaborators dialog where you can see the list of collaborators, their full user names, and can add or remove collaborators.

Manage Collaborators dialog

Manage collaborators#

This dialog shows you the existing collaborators for the Workspace and lets you add or remove collaborators. It opens when you select "Collaborators" using the 'Add' button button or when you click the Collaborators section's 'plus' button button. Each section of the dialog is explained below.

Find People#

Search for Datameer users to add as collaborators and search through your existing list of collaborators.

As you enter information here, the "Owner and collaborators" and "Add more people" sections below this will change to only show you the Datameer users that match your search terms. This will help you locate a particular collaborator on large projects or find Datameer users you want to add to your Workspace as new collaborators.

Owner and collaborators#

Displays the current owner and collaborators on this Workspace as well as any users you are adding as collaborators right now. The owner and current collaborators are marked with a check mark. Users you have just added as collaborators do not have a check mark.

Remove a collaborator by hovering over the check mark next to their name, which will turn into an X button. Clicking the X will remove them as a collaborator. Users you have just added as Collaborators will not have a check mark but hovering to the right of their name will still reveal an X button if you decide to remove them.

When you enter information in the search box at the top of the dialogue, this section will change to display only those collaborators that match your search terms.

Add more people...#

Displays the full list of Datameer users who can be added as collaborators on this Workspace.

When you enter information in the search box at the top of the dialogue, this section will change to display only those Datameer users that match your search terms.

Once you have found a user you wish to add as a collaborator, move your mouse over their name and click the button that appears to the right of their name.


Click 'Apply' button to save any changes you have made or 'Cancel' button to discard them. Closing this dialog without clicking 'Apply' button will discard any changes you have made.

Change ownership

Change ownership#

The owner of a Workspace can transfer ownership to another user using the 'Change Ownership' button button on the details page. Administrators can transfer ownership of any Workspace.

The new owner will be set to follow the Workspace by default. The old owner will automatically become a collaborator on the Workspace. Anyone following the asset will receive an Activities message about the change of ownership. Administrators will only receive an Activities message if they have followed the Workspace before they change ownership.


Comments appear on the right side of the Workspace details page with the most recent comments at the top. Any user can comment on a Workspace or reply to existing comments. Users following the Workspace will receive a notification in their Activities panel for new comments and replies.


Add a new comment by clicking on the 'plus' button button on the top right of the Comment section.

Delete a comment, including any replies, by clicking the dark 'Context menu' button conversations menu in the top right of the comment box.

Reply to an existing comment by clicking on it and typing in the new comment entry box that will appear underneath the comment. You can reply to comments from the Workspace detail page and also from the notification of a comment in your Activities panel.

Notifications of new comments go to anyone following the Workspace. Owners and collaborators follow the Workspace by default.

Note: notifications are tied to the individual asset, so comments on a dataset will not be sent to users following Workspaces where that dataset is created or referenced.


Add references to the datasets and documents you need for your project. References help you pull together documents you may need for a project and provide data so that you can build new datasets in the Workbench, but the content of references cannot be edited in a Workspace. See "What is a reference?" for details.

Newly connected or uploaded assets are added to Datameer and then referenced in your Workspace. Before adding new assets we recommend looking through the ones already in Datameer as these may have been prepared or enriched.

Add Dataset reference

Add Dataset reference#

This dialog lets you add dataset references to your Workspace. You can reference data that is already in Datameer or add new data. New data will be added to Datameer first and then referenced in your Workspace. Each section of the dialog is explained below.

Open the dialog by selecting "Data" using the 'Add' button button, clicking the Data & Documents section's 'plus' button button, or clicking the 'Add data' button button from the Workspace's Workbench.

Find dataset#

Find any dataset by entering its name, description, tags, or any column names it contains in the built-in "find magnifying glass" icon find tool at the top of this dialog.


The Sources section lets you browse through the data source systems your organization has connected to Datameer.

Click on a source to see the datasets inside it. When you find the dataset you want, click "Add to Workspace" to add a reference to it in your Workspace.

If you don't see the dataset you want, you can return to the list of sources using the button in the top left corner.

Add New From#

If the information you need is not in any of the connected sources, use the icons at the bottom of this dialog to add something new to Datameer. Newly connected or uploaded materials will first be added as assets to Datameer and then referenced in your Workspace.

Select the appropriate icon for the type of system you need to access and follow the prompts in the new dialog that opens.

Details for how to configure each different type of system are available on the "Connect" page.

Newly configured sources will be introspected as normal so that other datasets stored on them can be discovered through Datameer.

Add Document references

Add Document reference#

This dialog lets you upload files that will be added to Datameer and then referenced in your Workspace. It opens when you select "Document" from the Workspace's 'Add' button button or when you select "Upload File" from the add dataset dialog.

To reference a document that already exists in Datameer, use the 'Add to Workspace' button button from the document's detail page or select "Add to Workspace" from the context menu of the Document's search result (see Find assets for details).

Drag and drop any files you wish to upload or use the add buttons to browse for files and folders on your computer. When a folder is uploaded, each file will be turned into a separate document or dataset depending on its file type. A progress bar will indicate the upload status.

Files in CSV, XLS/XLSX/XLSB, JSON, and Parquet formats become datasets in Datameer and can be viewed and interacted with inside a Workspace's Workbench. All other formats (including PDF, DOC, and image files) are handled as documents.

See uploading files for full details on handling of different file types, upload limitations, and other features of uploading files.

Any files you upload will live in your company's Datameer environment and all the other Datameer users in your organization will be able to read and use them in their own work. Please consider the confidentiality of files before uploading them to Datameer.

Remove references

Remove references#

Document and dataset references can be removed from a Workspace through their context menus. References that have been removed from a Workspace will still exist in Datameer and can be added to this or other Workspaces in the future.

Remove a document reference:

  1. find it in the Data & Documents section of the Workspace's detail page
  2. move your mouse to the right of the document's name
  3. click the context menu 'Context menu' button button that will appear
  4. select "Remove"
  5. Your document reference has been removed from the Workspace

Remove a dataset reference:

Dataset references can either be removed using the above method or you can right-click on the dataset in the Flow section and select "Remove" from the context menu there.

Create datasets with the Workbench#

Once you have added references to the data you need for your project, you can create a new dataset in the Workbench.

Open the Workbench by clicking the 'Open in Workbench' button button on the Workspace details page or by double-clicking on any of the elements in the Flow area. Once in the Workspace, follow the "Create new dataset" instructions to begin transforming the data you have gathered into the form that your project needs.

From inside the Workbench, you can get back to the Workspace detail page using the 'Return to Workspace' button button or by clicking the Workspace's name in the breadcrumbs at the top of the page, circled here in red: