Help centre

Install and allow access

About 10 minutes. You need to be a Google Workspace™ super admin.

1. Install OrgbrightInstall it for your organisation from the Google Workspace™ Marketplace (Admin install). Install it for everyone if you want staff to open the chart from the Gmail™ side panel; they can also use a sign-in link.
2. Allow read-only accessOpen Gmail™, click the Orgbright icon in the side panel. It shows a client ID and one read-only permission, https://www.googleapis.com/auth/admin.directory.user.readonly. In Google Admin™ go to Security → Access and data control → API controls → Manage domain-wide delegation → Add new, paste both and click Authorise.
3. Set up OrgbrightWait a few minutes, then click Try again and Set up Orgbright in the side panel.
4. Open the chartClick Open org chart. If anyone is missing, see Why is my chart flat?

Why is my chart flat or missing people?

Orgbright draws the chart from the Manager field on each person's profile in Google Admin™. People with no manager, or with a manager who has left, appear under Not on the chart yet.

As an admin, open Fix reporting lines in Orgbright. It lists everyone who needs attention, grouped by the problem:

• No manager set: add their manager in Google Admin™ → Directory → Users → the person → User information → Employee information.
• Manager has left or doesn't exist: choose their new manager.
• Manager outside your organisation: the manager's address isn't in your Google Workspace™.
• Reporting loop: two or more people report to each other; change one of them.

Changes show in Orgbright within 10 minutes, or straight away with Refresh from Google.

Hide people, teams or details

In Settings, admins can hide shared mailboxes and room accounts by email, hide whole organisational units (and everything under them), and switch off fields such as phone numbers for staff. Name and email always show. Admins always see everything.

If you hide someone who has people reporting to them, those people move up to the next visible manager.

Choose what shows on the chart

In Settings, admins can:

• Pick card and panel fields: tick what appears on each card and in the side panel, and use the arrows to set the order.
• Use custom fields: any custom attribute you keep in Google Admin™ (Directory → Users → More options → Manage custom attributes) is listed once at least one person has a value. Tick Use, give it a friendly label, and choose whether staff can see it and whether the directory can be filtered by it.
• Brand it: add a link to your logo (it must start https://), an accent colour, department colours, and compact cards.
• Add open roles: a job title, department, location and who it reports to. Open roles live only in Orgbright and show as dashed cards.

Dotted lines and assistants

Orgbright reads the dotted-line manager and assistant relations on each Google profile and shows them on the card and in the side panel. Google Admin™'s user page only edits the main manager, so these relations are set through the Directory API, Google Cloud Directory Sync or your HR system's Google sync. Email us if you need a hand.

Fields and teams

In Settings → Fields & teams:

• Where details come from: choose which Google field fills Location, Phone, Department and Job title. For example, use the work address town instead of a building code, or the mobile number instead of the work phone.
• Required for everyone: tick photo, job title, department, phone or location. Anyone missing one is listed on the Fix page.
• Your fields: add fields of these types: text, date, number, yes/no, dropdown, multi-select or person. Tick Required to list anyone who hasn't got a value, and Staff can see to show it to everyone (otherwise only admins and the person themselves can see it, in Google too). A field with no value for someone simply doesn't show for them.
• Teams: the Teams field is ready to use. Type your team names, one per line. People can be in more than one team. Staff can then pick a team above the chart to highlight it, and you can colour the cards by team.
• Archive stops using a field but keeps its data in Google, so you can restore it later. Once a field holds data its type can't change, because Google doesn't allow it.

Turn on editing

Orgbright is read-only until you turn on editing. To let your Orgbright admins fill in your fields from Edit details on anyone's card:

1. In Google Admin™ go to Security → Access and data control → API controls → Manage domain-wide delegation.
2. Edit Orgbright's client ID and add these two permissions next to the read-only one: https://www.googleapis.com/auth/admin.directory.user and https://www.googleapis.com/auth/admin.directory.userschema. Click Authorise.
3. Reload Orgbright. Settings → Fields & teams now says "Editing is on".

Be aware: Google grants these permissions for all user details, not just custom fields. Orgbright's code only creates one custom attribute group called Orgbright and saves the values your Orgbright admins enter into it; it never changes names, managers, passwords or admin rights. Every edit is in Orgbright's activity log. To turn editing off again, remove those two permissions.

Fields marked Staff can see are set in Google to be visible to everyone in your organisation, so they can also appear in Google's own directory and contact cards. Other fields are visible only to admins and the person themselves.

Who can see the chart

Anyone currently in your Google directory can open the chart, from the Gmail™ side panel or a sign-in link sent to their work email. Suspended accounts and people outside your organisation can't. Sign-in links work for 8 hours.

Google Workspace™ admins can change settings. To let someone else (for example HR) change settings, add them under Settings → Orgbright admins.

Plans and billing

Orgbright is free for up to 25 people. Team (£15 a month, up to 100 people), Business (£39, up to 500) and Large (£79, up to 2,000) are flat monthly prices. Choose a plan from Settings; payment is through Stripe and receipts come from Ironbit Ltd.

Once you're on a paid plan, use Manage billing in Settings to move to another plan, change card, download invoices or cancel. Cancelling takes effect at the end of the month you've paid for. If you go over your plan's size, the chart keeps working and admins see a note.

Remove Orgbright

Uninstall Orgbright from the Google Workspace™ Marketplace and remove its client ID from domain-wide delegation in Google Admin™. Uninstalling the add-on on its own doesn't remove that access. When Orgbright can no longer read your directory, we wait 30 days (in case it was a mistake) and then delete your settings and activity log. Any paid plan stops at the end of the period you've paid for. To delete sooner, email privacy@orgbright.app.