Book a demo, get a 14-day free trial. →
BuildersAI
Help Centre

Who Can See What (Roles & Permissions)

This is the same guide SiteBot reads. Inside the app you can ask it any of this in your own words, and it answers from this page.

A dialog headed with a person's name, reading What they can do across your organisation and on each project, with In your organisation set to Contact above a list of five named projects, each with its own role dropdown set to Project Member.

Every person on a project is an Admin, a Member, or a Follower. The role decides both what they can do and what they can see.

That role can come from two places. It is either set on the project itself, or it comes from your standing in the company account (your organisation). There are four standings:

So an Organisation Admin is an admin of your job without ever having been added to it, and an Organisation Member is a member of it the same way. A Contact holds nothing until somebody gives them a project. Three of those four are set on the company’s own People list (the owner is handed over in organisation settings instead), which is also where seats are spent and where somebody can be taken off the company altogether. See the “organisation_people” topic.

Staff are on every project the organisation owns, and a new job puts them on it the day it is created. One person can hold a role both ways at once: your own foreman is staff, so he is on every job, and he may also have been added to this one by name.

Telling the two apart, in the browser. Every role badge on the People page says where the role came from. A plain badge is a role this job set. A badge with a dashed edge and · org after it is one that comes from your organisation. Their Permissions says the same in words, a line per project: “Project Member, from the organisation”, or “Project Admin” on its own when this job decided it, or “Project Member, from the organisation · also added to this job directly” when both are true. Inside a project the phone shows the role but not where it came from. An administrator can read it on the phone under All projects, People, the person’s Permissions. For where those buttons are, ask about team and people (the “team_management” topic).

Why it matters when somebody can see a job you did not expect:

Shutting one person out of one project (browser).

Sometimes there is one job somebody should not see: a client’s private site, a dispute, work being priced. You can shut one person out of one project without touching anything else they have.

  1. Open the project’s People page in the browser
  2. Click the person to open their profile
  3. Scroll to Danger Zone at the bottom and click Remove from Project
  4. Read the box, then click Remove. For somebody who is on this job through your organisation it says so: they keep their place on your people list and all their other projects, and any tasks they are assigned to here are kept, so nothing is lost if you let them back in

What it does. They come off this project’s People list and this job stops existing for them. They keep their standing in your company and every other project. If they were only ever added to this one job, there is nothing above them to shut out, so it is an ordinary removal: they come off the job and their assignments here go with them.

Where they go, and how to undo it. Below the role groups on that same People page is a section headed Excluded from this project, with an eye-with-a-line-through-it icon and a count beside it. It appears only once somebody has actually been shut out, and only project admins see it. Each row says what the button will do:

Click Let back in to lift it. Adding them to the project again works too, and gives them whichever role you pick as you add them.

Worth knowing:

Admin: runs the project. Manages the team, uploads drawings, changes settings, writes announcements, handles billing. Sees everything.

Member: does the work. Creates and updates tasks, uploads photos and files, comments, checks in and out, writes the site diary, manages their own certifications. Sees the whole project’s tasks.

Follower: reads, and only their own corner of the project. Typically the client, their representative, or a subcontractor pulled in for specific work. A follower can comment and add photos on a task they are assigned to or created, and nothing else: no tasks, no labels, no changes to a task, and no comments or photos anywhere else.

What a follower can add to their own task:

The important part: a follower does NOT see the whole project.

A follower sees a task only if they are involved in it. That means one of three things:

Any other task in the project is invisible to them, along with its comments, its labels, its attachments and who is assigned to it. Their task list is genuinely their own list, not a filtered view of the project’s.

A follower also cannot see:

Adding a follower to a task: assign it to them, or @mention them in a comment on it. A mention is a real grant, not just a notification: the moment you mention someone in a comment, that task and its whole thread become visible to them. Worth remembering before mentioning a client on a task that discusses cost or a dispute.

Taking the mention back out of the comment, or deleting the comment, removes that access again (unless they are also assigned).

A private task is the one exception. Mentioning somebody in a private task tells them about it, but it does not let them open it. Only the person who created it, the people assigned to it and the project’s admins can see a private task. To let somebody else in, assign them to it or switch Private off on the task.

Access levels on files and photos are separate from roles. Each file, folder, album and photo is set to one of:

So a follower sees only “everyone” content, whatever their task access.

Changing someone’s role:

Removing someone from a project is different and stronger: they lose access immediately, and their task assignments are deleted. If you invite them back later they regain the tasks they created and the ones they were mentioned in, because those are still on the record, but their old assignments do not come back and have to be set again. The app tells you how many tasks they are assigned to before you confirm.

“Why can’t I see this task?” If someone is a follower, the answer is almost always that they are not assigned to it and have not been mentioned in it. An admin or member can fix that by assigning them or mentioning them in a comment.

Who can do what: