« Back to help center

Admin guide

This guide will show you how to add data sources, create dashboards, and manage users.

Contents

Admin guide

1. Getting started

When you log into Contiamo, the welcome screen will show the list of projects that you are a member of.

In order to get started, please:

welcome_screen

Whether you enter an existing project or create a new one, you will land in the Activity section of the project. This page features a few shortcuts to common admin tasks:

admin_shortcuts

In this tutorial, we will perform admin tasks from the Manage section, which is accessed from the navigation bar at the top of the page:

navigate_to_manage_view

In this section, you can manage data sources, users, and more. Dashboards are managed from the Dashboards section, also accessible from the navigation bar.

To get started, please navigate to the Manage section of a project where you are an admin.

1.1. Getting help

You can get help at any moment by:

These functions are accessible from the top right corner anywhere in Contiamo:

help_menu

2. Data sources

In addition to your own data, Contiamo can integrate data from a variety of external sources such as Google Analytics or Facebook. Connectors to these data sources are can be installed in just a few clicks.

Below is an example list of available connectors. We are constantly adding new connectors, and you can suggest new ones to support@contiamo.com.

app_list

2.1. View installed data sources

The Data sources tab in the Manage section (which is the default landing tab) provides an overview of data sources currently installed in your project:

installed_apps

The Status column relays information on potential connection problems. A green ‘connected’ status means that we have not detected any problem with the data source.

2.2. Add a standard data source

Plese refer to the data integration help for detailed instructions.

2.3. Share data sources

Data sources can be shared between projects. A typical use case would be for a parent company to have a consolidated view of its subsidiaries’ projects. Shared data sources can be managed from the appropriate tab:

shared_apps

Access to an data source is granted from within the project that hosts the data source.

grant_shared_app

Navigate to the Granted to other projects list, and click + Add new grant.

shared_apps_menu

The data source should be renamed if the target project is intended to host identically named sources from different projects.

3. Dashboards

Note: Unless you are already familiar with Contiamo as a user, we recommend that you take the user tutorial, where you will learn how to create the widgets that populate a dashboard.

The Dashboards section (accessed from the navigation bar) lists the dashboards in your project. Here you can view an existing dashboard or add a new one.

3.1. Edit an existing dashboard

Select a dashboard from the list (when we create a first project for you, we include at least one example dashboard). As an admin, you can edit the dashboard by clicking on the edit dashboard button above the dashboard.

configure_dashboard

3.2. Modify an existing widget

Dashboards are populated with widgets, which are visual representations of your data such as tables and charts.

In edit mode, each widget displays a menu that lets you edit, delete, and copy (duplicate) the widget. You can also enter a title, move the widget around by grabbing the top border of the widget window, and resize the widget by pulling from a border or a corner.

edit_widget

If you click Edit, you enter a view that is identical to the explore section covered in the user tutorial, and you can modify the widget exactly as described there.

Note: The same explore view will open if you click on the top border of a widget when not in edit mode. You will not be able to save any changes you make there directly, but you can always re-export the modified widget to the dashboard as described below.

3.3. Add a new widget

Select one of the chart types from the edit toolbar, and a new widget pops up:

dashboard_edit_tools

You can edit and move the widget as would any existing widget. You can also change the widget type (e.g. from line to bar chart) after the fact.

3.4. Create a new dashboard

Go back to the main Dashboards section via the navigation panel. Click on + Add new dashboard, and the following dialogue will pop up:

new_dashboard_menu

You have a choice between two layouts, screen and report, which are described in the dialogue. After entering your dashboard’s name and creating the dashboard, you can add and edit widgets like you did for existing dashboards above – except of course that you will start with a blank slate.

3.5. Import a widget

If you want to populate a dashboard with existing widgets from another dashboard, you can:

export_query

3.6. Settings

In the settings (accessible from the edit toolbar) you can set user permissions, set up notifications, apply a different theme, or change the layout. More importantly, this is where you can delete a dashboard:

delete_dashboard

4. Managing users

Each project has two types of users:

An admin has all the rights required to run the project, i.e. add dashboards, data sources, and users. Users can view, edit or own dashboards, data sources and notebooks. Prerequisite is that the user has been granted permission to view, edit or own that particular resource.

4.1. View users

Users are managed in the Users tab of the Manage section:

manage_users

This tab displays the list of current users, and lets you add, remove, or change the role of users.

add_remove_user

4.2. Invite a user

Inviting users is fairly straightforward: enter their email address, pick a role, and send the invitation.

After inviting users, make sure you give these users permission to data sources, dashboards, or notebooks as required.

4.3. User groups

User groups can be created in the Groups tab next to the Users tab. Permission to view dashboards can be granted in bulk by adding the group in the permission settings.

Notifications (also managed in each dashboard’s settings) can also be sent to groups.

5. Permissions

In this section, you will learn how users and groups of users within Contiamo can be set to have differing levels of access to data sources, dashboards, presentations or notebooks.

There are two user groups – admins and users. Admins have access to all Contiamo resources, are able to invite new users and set users’ permission level for specific items. Users can have three different permission levels: View, Edit and Owner.

5.1. Recent changes

Our permission structure has recently changed to ensure you can easily share your insights, with relevant audiences, while keeping your data secure.

The section below will outline the new permission structure. However, for existing entities, the permission structure mirrors the structure that was in place prior to these new permission features being released.

5.2. Permission levels

In this section, we will run through what each of permission level means.

"View" permission

View permissions give the user the ability to see the entity and use it, but not to edit it.

For example, users with View permissions for a data source are able to explore that data source fully and use it in their own dashboards, notebooks and presentations. The user is not able to edit or delete that data source.

For dashboards, notebooks and presentations, the user is able to view all elements of these entities, regardless of whether they have View, Edit or Own permissions of the underlying data sources. Once again, the user is not able to edit or delete these entities.

"Edit" permission

Edit permissions are similar to the View permission with the only differentiating factor being that they can edit the entities that they have permission to. This allows a user to, for example, change the layout or edit and delete individual widgets within that dashboard.

"Owner" permission

A user with Owner permissions has two additional rights over a user with Edit permissions. Firstly, they are able to assign user permissions to other users or groups of users for that entity. Secondly, they are able to delete an entity.

5.3. Setting permissions

When you add new entities (data sources, dashboards, presentations, etc.) to your Contiamo account, only admins will inherently have permission to view, edit or delete the entity.

To provide access to users, you must set these permissions manually. Let’s look at changing permission structures for a data source first. After adding a data source as normal, go to that data source in your list of existing data sources and click the icon in the top right corner as in the image below.

select_permissions

After clicking on permissions, a new window will appear, as below. Here you are able to provide users or groups of users with differing permission levels by clicking on the desired users or groups of users on the left-hand side. This will take them to the list of users permitted to view, edit or own the data source on the right-hand side. Click the arrow to reveal a drop-down menu where you can choose that user’s or group of users’ permission level.

manage_resource_permissions

To select users permitted to view, edit or own dashboards, notebooks or presentations, you follow the same process as outlined here.

Additionally, you can edit permissions for existing data sources, dashboards, notebooks and presentations.

5.4. Permissions FAQs

What are the key advantages of the permission structure?

Firstly, not everybody needs to be an admin to get access to specific entities. Every user who has permission to view a specific data source is now able to explore this source and build their own dashboards, notebooks and presentations using the data.

Secondly, you are now able to begin building dashboards and experimenting with your data incognito. You only need to make this available to your colleagues once you are happy with the outputs.

Finally, data can be shared far more easily within your organization, while still maintaining maximum security of confidential data. Contiamo is now much more flexible with what data and insights you share with which members of your organization.

Why can nobody else see my data sources, dashboards, notebooks or presentations?

All data sources, dashboards, notebooks or presentations are automatically created with the user who created the entity, along with the project admins, being the only users with permission to view, edit or own the dashboard. You must edit the permission structure, as outlined above, in order to provide permission rights to additional users or user groups.

What will happen to my existing data sources, dashboards, notebooks or presentations?

In order to minimize disruption during this new release, we have ensured that all existing entities have the same permission structure as before the release. To use this new permission structure with existing dashboards, you may follow the steps as outlined above.

Why am I not able to see my colleague’s data source, dashboard, notebook or presentation?

You are not able to see this specific entity because your colleague has not provided permission for you to do so. To view, edit or own a data source, dashboard, notebook or presentation, your colleague or an admin must follow the steps as outlined above, choosing the right permission level based on the description above.

Why is my colleague able to see widgets containing data from a source he does not have access to?

If a user is assigned permission to view, edit or own a specific dashboard, they are able to see all the insights presented within that dashboard. However, they will be unable to explore the underlying data if they have not been given access to the underlying data source.

I am viewing my colleague’s dashboard. Why am I not able to explore the data within individual widgets?

You are unable to explore individual widgets because, although you have permission to view, edit or own a specific dashboard, you have not been given permission for the underlying data source. To be able to explore the data within individual widgets, your colleague must assign you permission for the underlying data source by following the steps outlined above.

I want to create a data source, dashboard, notebook or presentation that my account admins are not able to see. Why am I unable to remove them from the permission structure?

Admins have access to all Contiamo resources, are able to invite new users and set users’ permission level. As such, they have owner permissions on all entities for your organization. If you believe someone has incorrectly been assigned admin rights to your account, contact Contiamo customer support using the chat panel in the upper right corner of this window.