Share records with users and teams

To give users access to records in addition to those they own, you can share individual records. You can share HubSpot-defined and custom objects that have a record page (e.g., contacts, appointments, deals). When you share a record with a user or team, it gives the user or primary members of the team access to the record consistent with each user's object permissions. For example, if you share with a user that has permission to view their own contacts but doesn't have permission to edit or delete contacts, they can view the record but cannot edit or delete it. 

Users with Super Admin permissions or access to edit the Shared users or Shared teams properties can share records.

Please note: your account may use personalized names for each object (e.g., account instead of company). This document refers to objects by their HubSpot default names.

Manage access to the Shared users/teams properties

To manage which non-admin users can edit the properties:

1. In your HubSpot account, click the settings settings icon in the top navigation bar.
2. In the left sidebar menu, navigate to Properties.
3. Click the Select an object dropdown menu, then select the object with the properties to edit (e.g., Select the contact object to manage contact sharing permissions).
4. Search for Shared.
5. Select the checkboxes to the left of the property names, then click Manage access at the top of the table.

6. In the right panel, update access:
   • Private to super admins only: only admins can view and edit the property. This means only admins can share records.
   • Allow everyone to view and edit: all users in your account can view and edit the property. This means all users can share records.
   • Allow everyone to view: all users can view the property's values, but only admins can edit the value. This means only admins can share records.
   • Assign to users and teams: set the level of access allowed for each team or specific users. You can give view only access or both view and edit access. Any user or team member with view and edit access can share records.
7. Click Save.

Share records

Share records on an object index page

To share records from the object's index page:

1. Navigate to your records (e.g., In your HubSpot account, navigate to CRM > Deals.).
2. Select the checkboxes next to the records you want to share.
3. At the top of the table or board, click Share.

4. In the dialog box, select the users and/or teams with which you want to share the record.
5. Click Share to confirm.

Share records via a workflow

To automatically share records with users and teams based on criteria, create a workflow to set the Shared users/teams property for a given object:

1. In your HubSpot account, navigate to Automation > Workflows.
2. Create a workflow based on the object with the records to share.
3. Set your enrollment criteria.
4. Add the Edit records action.
5. Click the Property to edit dropdown menu, then select Shared users or Shared teams.
6. Click the Choose a value dropdown menu, then select the users or teams with which to automatically share records.
7. Select whether the users/teams will be added to or replace the current selected users/teams:
   • Select Append to current value(s) to add to the property's existing values.
   • Select Replace current value(s) to overwrite the property's existing values.

8. Click Save.
9. Finish setting up your workflow.

Once the workflow is published, if a record meets the enrollment criteria, the record will be shared with the selected users/teams.

View the users and teams with access to a record

To review which users and teams have access to a given record, you can:

• View the record's values for the Shared users and Shared teams properties.
• View the record access panel on a record.