Skip to content
English - Australia
  • There are no suggestions because the search field is empty.

Hosts, roles and permissions explained

This article covers the differences between company and site hosts, and the types of role-based or individual permission based access you can provide.


Overview

Permissions determine whether or not users will have access to the web portal, and the host panel on the mobile app. In Breadcrumb, there are two settings that control this access:

  1. Host type: This controls whether you have access to data across all sites (company host), or access to a select few individual sites (site host).
  2. Permission type: This controls what a user can do once they're there, such as checking workers in, approving permits or editing site settings.

You set permissions in one of three ways: by giving someone a pre-determined role, by choosing their permissions for them individually, or by using a mix of both. If using both, the system will always default to the highest level of access provided.

This article explains the best practices for these hosts, roles and permissions.


Host types

Company host

A Company Host looks after your Breadcrumb account as a whole, and are typically your full administrators. They can see every site, and they’re the only people who can:

    • Add hosts and assign permissions
    • Edit induction and form templates
    • Change company-wide settings
    • Manage your integrations

    Being a Company Host doesn’t give someone every permission. They can still only use the features their role or individual permissions allow, it just gives them access to all sites.

    Because their changes affect every site, we recommend limiting this host type to a select few administrators who are fully trained on Breadcrumb. It is considered best practice to have only users with full access to all permissions set as company hosts.

    Company host permissions

    Site host

    A Site Host manages the day to day on the sites they’re assigned to. Someone is assigned to a site when a Company Host adds them, or when they’re linked to via an integration (like Procore). Site Hosts can see each assigned site’s settings, suppliers and assets. They can’t:

    • See sites they aren’t assigned to
    • Edit induction or form templates
    • Change Company Settings or Integration settings
    • Add hosts or assign permissions

    What a Site Host can do on their sites depends on their permissions. For example, they need Modify Site to edit site settings and Approve Or Reject Approval to approve permits.

    This role is typically for your site management teams, and applying the below permission set to your site hosts is considered best practice.

    Site host permissions


      Permission types

      To select a permission type, click on your name in the top-right corner and go to Company Settings > Permissions Settings > Permission Mode. From here, you can select from role-based permissions (recommended), individual user permissions only, or mixed (both).

      Role-based permissions (recommended)

      A role is a named set of permissions, such as Site Manager or Contract Administrator. You create the role once, choose its permissions, then give it to everyone who does that job. Everyone with the same role has the same access.

      • To create a role: Click your name in the top-right corner and go to Company Settings > Permissions Settings > Role Definition.

      • To give someone a role, go to Permissions, find them on the Company Host or Site Host tab, select Edit, and choose from the Roles dropdown.

      If you use an integration partner like AutoDesk or Procore, your project roles will sync into Breadcrumb automatically. You still need to set each role’s permissions in the Breadcrumb company settings, but you won't have to worry about assigning them.

      Individual user permissions

      Individual permissions let you choose features for one person without using a role. They suit exceptions, such as someone who only needs access to reports.

      • To set them permissions: Click your name in the top-right corner and go to Permissions. Add or edit the person, then choose their features from the Permissions dropdown. All Permissions gives them access to everything.

      Individual permissions are set one person at a time. If what a job needs changes, you have to update each person separately. This is not considered best practice.

      Mixed permissions

      You can enable both role-based and individual permission sets. This is useful when one person needs a little more than their role, e.g. a Site Manager who also wants to access site settings. 

      If using both, the system will always default to the highest level of access provided.


      Related articles


       

      Need help or have a question?

      Contact our Support Team on 1300 744 666 or email support@breadcrumb.co.

      We’re happy to help!