Create and maintain client companies, run bulk actions on many companies, and find user and team administration.
Companies Settings is where MSP staff create client companies, edit their details, import them from your PSA and change many companies at once. Client users and roles live in Settings > Users & Roles.
Before you start
You need Companies settings access. Read access lets you view companies. Write access lets you add, edit and run bulk actions. Manage access is also needed to delete companies, turn AI Home or a company’s AI on or off, and open Blocked Companies and Hardware defaults.
Premium Training actions need the Training manage permission.
To import companies, connect a supported PSA first. See Import Companies.
New from import also needs Integration Company Mapping write access, because the new company is linked to its PSA record.
Company users cannot use this page.
Find a company
1
Open Companies
Go to Settings > Companies.
2
Filter the list
Use the column filters. Company searches by name. Status, Training (Premium or Standard) and M365 (Connected or Not Set) are lists. Integrations and Types let you pick several values. The Industry column is hidden until you turn it on from the column menu.
3
Check badges before editing
A Parent or Child badge shows the company hierarchy. Imported from shows the PSA that created the company. Similar names can be different companies, so check the badges first.
Each row has a … menu. With write access it shows Edit Company. With read access only, it shows View Details & Users.
Create a company
1
Open the form
Click New Company in the page header, then Blank company. The Add New Company dialog opens. New from import is listed too when a supported PSA is connected and your role can import companies.
2
Enter the details
Enter the required Name. Add Contact Name, Contact Email, Contact Phone, Website, Industry, Company Size and Primary Domain as needed.
3
Scroll to the rest of the form
Below the contact fields, set the Address, Active, Compliance Schedule, Business Review Schedule and Year-end Date.
4
Save
Click Save Company. A message confirms the company was created. Cancel closes the form without saving.
The top of the Add New Company form. The address, active state and schedule fields continue below, and Save Company is in the dialog footer.
A contact email on a company does not create a portal user or send an invitation. The Compliance Schedule and Business Review Schedule fields set meeting frequency. They are separate from automated compliance run schedules.
Create a company from your PSA
Use New from import to bring one client in from your PSA and link it to your other tools in the same dialog. It works with Halo, ConnectWise, Autotask, Syncro and ConnectWise Asio.
1
Open New from import
Click New Company in the page header, then New from import.
2
Pick the PSA company
If you have more than one PSA connected, choose it in Import from. The list shows only that PSA’s companies that aren’t in MSPortal yet, with their type. Search to narrow it, select one company, and click Import and continue. A message confirms the company was created.
3
Review the matches
MSPortal checks your other connected tools, such as your RMM, backup and documentation tools, for records that match the new company. It uses the same matching as Review likely matches in Integration Company Mapping. Each match shows the tool, the record and a confidence score, and every match starts checked. Uncheck any that belong to a different client.
4
Link or skip
Click Link (the button shows the count, such as Link 3 matches) to link the checked records and close the dialog. Click Skip to finish without linking. Open company goes to the new company’s page.
New Company in the page header offers a blank company or one imported from your PSA.
Pick the PSA company to create. Only companies that aren't in MSPortal yet are listed.
When nothing in your other tools matches, link the company later from Integration Company Mapping.
Matching only suggests records that aren’t linked to any company yet, and skips tools where the new company already has a link, such as the PSA it came from. Each tool offers its best match. A record that matches an existing company better stays with that company. Link it by hand in Integration Company Mapping if it belongs to the new one.If the company is inactive in your PSA, it’s created as inactive and the dialog says so. Activate it on its page, then link its tools from Integration Company Mapping.
Edit a company
1
Open the company
In the list, open the row’s … menu and click Edit Company. The company page opens on the Overview tab.
2
Edit a field
Point at a field and click the pencil icon. Change the value, then click the check mark to save, or the X to cancel. Each field saves on its own.
3
Open another tab
Use the tabs at the top to work on the rest of the company. Each tab saves separately.
Tab
What you do there
Overview
Edit contact, address, industry, language, currency, time zone, size, parent company, types, schedules, year-end date, Compliance Required and custom fields. See the PSA, Microsoft 365 and device integration cards
Add, edit, duplicate or delete physical locations, or import sites from your PSA. Changes here stay in MSPortal and never reach your PSA
Defaults
Set company defaults on the Recurring meeting defaults, Import, Communication, Hardware, Software, Location, Security and Tickets sub-tabs. Click Save Defaults to save
Ticketing
Set the default PSA routing for this company’s tickets and choose which ticket templates are available to it. For a template with branches, choose the version this company uses: Main form, a branch, or Off
Team
Assign MSP staff to this company’s team roles
Notes
Keep account notes and the QBR log
In Defaults > Recurring meeting defaults, Quarterly and Yearly meetings can also use Target month or quarter. It sets the first occurrence of new bookings and is independent of Suggest a schedule. Click Save Defaults to keep the target; existing bookings keep their dates. See Recurring Meeting Booking.
If a value changes back after a sync, your PSA owns that field. Change it in the PSA.
Add a location
1
Open the company menu
In the company list, open the row’s … menu and click Add Location. You can also use Add on the Locations tab.
2
Fill in the dialog
In Create New Location, enter the Name and the address, phone, email and notes you want.
3
Create it
Click Create Location.
Locations never sync back to your PSA. A location you add, edit or delete in MSPortal changes only MSPortal; ConnectWise, Autotask, Halo and other PSAs keep their own sites. To change a site in your PSA, change it there. Locations imported from your PSA update on its next sync, which replaces any edits made to them in MSPortal.
A parent company and a location are different things. A location is a physical site of one company.
Import companies
To bring in a single company and link its tools in one step, use New from import. Use Import for several companies at once.
In the import dialog, Quick Match, bulk Assign, filter counts and Clear Filters share one toolbar. On a phone, open Filters to search.
1
Open the Import menu
On Settings > Companies, click Import in the page header. It shows only when a supported PSA is connected.
2
Choose the provider
Click Import from and your provider’s name. The import dialog opens.
3
Select and import
Pick the companies to import. You can link each one to an existing company or create a new one. Follow Import Companies.
Check Integration Company Mapping before you create a company that may already exist. Some selections create the company before the link is applied, and Cancel does not undo them.
Run a bulk action
1
Select companies
Tick the checkbox on each company. To include companies on other pages, choose all matching companies across pages.
2
Open the Actions menu
Click Actions (count) in the page header. The count shows how many companies are selected, or All N for a cross-page selection.
3
Choose the action and confirm
Pick an action from the table below. Check the dialog’s company list before you click its apply button.
Action
What it does
Assign Teams to Selected
Assigns or unassigns team roles for users across the selected companies. Changes apply immediately
Set Parent Company
Makes the selected companies children of another company. A company cannot be its own parent or the parent of its own ancestor. Choose No parent company to remove the relationship. Click Update Parent
Sets Business reviews and Compliance reviews frequency. Keep existing leaves a schedule alone. No schedule removes it. Click Apply schedules
Enable Premium Training / Disable Premium Training
Turns Premium Training on or off at once. Needs the Training manage permission
Enable AI Home / Disable AI Home
Turns AI Home on or off at once. Needs manage access
Turn off AI / Turn on AI
Stops or allows every AI feature for the selected companies. See Turn off AI for a company. Needs manage access
Delete Selected
Permanently deletes the selected companies. Needs manage access
Enable and Disable Premium Training, Enable and Disable AI Home and Turn off AI / Turn on AI apply as soon as you click them, with no confirmation dialog. Training availability, user overrides and enrollment are separate settings. See Enable Training.
Turn off AI for a company
Use this when a client must not have any of its data used by AI, for example because its contract or its own policy forbids it. Your other companies keep AI.
1
Open the company
In Settings > Companies, open the company. On the Overview tab, find the AI card.
2
Turn off Use AI with this company's data
The change saves right away. To change several companies at once, select them in the list and choose Turn off AI from the Actions menu, or use Turn off AI in a row’s … menu.
The AI column in the company list shows Off for every company with AI turned off.While AI is off for a company:
None of its data is sent to an AI model. The assistant, its tools, RON, the Chrome extension and MCP clients cannot see the company or any of its records, even when you ask about all companies.
AI reports for it are blocked: AI narrative reports, report presentations, AI report editing and AI sections of scheduled reports. Reports without AI still run.
Ticket AI, meeting summaries, planner and compliance note drafts, survey analysis and other AI features refuse the company, or leave it out when they cover many companies.
Background AI jobs skip it, including feedback triage and automation AI Transform steps.
Its company users see no AI features, the same as when Enable AI features for client users is off in Tenant Settings.
While any company has AI off:
Assistant conversations that started before AI was turned off start fresh, so earlier answers about that company are never reused.
Searching all companies from the assistant needs a company selection. Pick the companies you want in the company selector.
AI standards suggestions are unavailable.
A survey’s overall analysis and sentiment cover only the answers from companies with AI on.
Turning AI back on takes effect right away. Nothing is deleted while AI is off.
Manage company types
Types group companies for filters, reports and ticket-template availability. A company can have several types. Manual types are created in MSPortal. PSA-synced types come from your PSA and show a tooltip, Synced from and the provider name.
1
Select the companies
Tick the companies. Use the column filters first to narrow the list.
2
Open Manage Types
Click Actions (count), then Manage Types. For one company, use Manage Types in its row menu. The Manage Company Types dialog opens.
3
Choose an action
Under Action, pick one option.
Option
Result
Add types (keep existing)
Adds the types you pick to each company
Replace all types
Replaces each company’s manual types with the ones you pick. PSA-synced types stay
Remove types
Removes the types you pick. The list shows only types on the selected companies
4
Pick or create types
Pick existing types, or type a new name and click Create type. A new type is saved right away. Cancelling the dialog does not delete it.
5
Apply
Click Apply. A message says how many companies changed. Check the Types column.
Removed types stay removed. Your PSA sync does not add them back unless you add the type again.
Set a custom field on many companies
Use Edit Custom Field to give one company custom field the same value on many companies. For example, set the same contract renewal date for a group of clients.
Before you start
You need write access to Companies settings, and your MSPortal billing must be active.
Create the field first. Open Settings > Customization > Fields, choose Companies, and save the field. See Custom Fields.
A Dropdown, Multi-Select or Radio Buttons field appears only after it has at least one saved option.
Set the value
1
Select the companies
In Settings > Companies, tick the checkbox beside each company. To include companies on other pages, select all matching companies across pages.
2
Open Edit Custom Field
Select Actions (count), then Edit Custom Field.
3
Check the selected companies
The Selected Companies list shows the first 30 names, then a +N more badge. Close the dialog and adjust your selection if a company is wrong.
4
Choose the field and value
Choose a field under Custom field. Then enter the Value. The input matches the field type, such as a date picker for a date field or a list for a dropdown.
5
Apply the value
Select Apply. A message confirms how many companies were updated, and the selection clears.
Edit Custom Field in the Actions menu for one selected company.
The Edit Custom Field dialog with a required date field and a value chosen. Clear Value is unavailable because the field is required.
Replace, clear and required fields
Apply replaces the existing value on every selected company. It does not add to it. For a Multi-Select field, the companies end up with exactly the options you chose.
Clear Value removes the field’s value from every selected company. You do not need to enter a value first.
Required fields cannot be cleared. The dialog disables Clear Value and says the field cannot be cleared. Apply still works.
Apply updates all selected companies together. If it fails, no company changes.
Clear Value works through the companies in batches. If it stops partway, the message says how many companies were cleared. Run Clear Value again to clear the rest.
To check the result, open the column menu and turn on the field’s column. Custom field columns are hidden by default.
Company users, access roles and team roles
You want to
Open
Manage client users
Settings > Users & Roles > Company Users, or a company’s Users tab
Define client access
Settings > Users & Roles > Roles > Company Roles
Define internal staff access
Settings > Users & Roles > Roles > Tenant Roles
Define account-team responsibilities
Settings > Users & Roles > Team Roles
Company Roles control client access. Team Roles describe MSP responsibilities, such as account manager. Assigning a staff member to a team role can limit their company selector to the companies they are assigned. A team role does not give a client user any permission.Every parent company has a Parent Admin team role. On the parent company’s Team tab, assign a client user to it to give them every child company and a company selector. See Give a parent-company user access to child companies. On a parent company’s row menu, Sync Roles to Children copies the roles of the parent company’s admin users to its child companies.On a company’s Users tab, the Email column lists any other addresses linked to a person, such as the address on their PSA contact or Microsoft 365 account, under their main email. The person’s details show every address under Email addresses. With Microsoft or Google sign-in, they can sign in with any of them.For permission changes, see Change a Company user’s permissions.
Auto-Mapping PSA Contact Types to Roles
If you use ConnectWise, Autotask or Halo, you can map PSA roles and contact types to your team roles. MSPortal then assigns people to a company’s roles from your PSA data on each sync.
1
Open Team Roles
Go to Settings > Users & Roles > Team Roles.
2
Edit a role
Click Add Role for a new role, or the edit icon on an existing one.
3
Pick the PSA roles
In the PSA column (CW Team Roles, Autotask Roles or Halo Roles), pick the PSA roles that should map to this team role.
4
Save the role
Click the check mark or press Enter. The next sync applies the mapping.
A Global team role is held by one named person and has no PSA mapping. Roles you do not map stay manually managed. A manual change to a mapped assignment can be overwritten by the next sync. See Account teams and Team Roles.
Delete a company
1
Open the row menu
In the company list, open the row’s … menu and click Delete Company. This needs manage access.
2
Read the warning
The dialog lists what is permanently deleted: company data and settings, compliance history, user associations, training records, tickets and locations.
3
Confirm
Click Delete Company. Deleting cannot be undone.
Do not delete a company to hide it or to fix an import. Change its status to inactive instead. A deleted company is blocked from being imported again. To allow it back, click Blocked Companies in the page header, select it and click Unblock. Unblocking lets it be imported again. It does not restore deleted data.Hardware defaults in the page header sets the global hardware standards that every company inherits. It applies to the whole tenant, not to one company.
Troubleshooting
Problem
What to do
New from import is missing
Connect a supported PSA. Your role also needs Integration Company Mapping write access
A PSA company isn’t in the New from import list
It’s already linked to a company in MSPortal. Search the company list for it, or check the link in Integration Company Mapping
A company is missing
Clear the list filters. Check Status, your access and your import mapping before you add a duplicate
The Actions menu is missing
Select at least one company. You need write access
Delete Selected, Blocked Companies, AI Home or Turn off AI is missing
These need manage access
The assistant says AI is turned off for a company
AI is off for that company. Turn it back on in its AI card, or pick other companies
Enable Premium Training is missing
You need the Training manage permission
A client cannot sign in
Check the person’s Company user record and Company role. A company contact email does not create a login
For participating tenants with Traffic Light enabled, the company header shows Amber, Red or Purple badges. Click the badges to show the reason, technician guidance, owner and review date. View in Customer Success opens the detail page when your role can read Client Health. Company portal users do not see this staff guidance.
Traffic Light is available only to tenants included in the pilot.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"MSPortal.ai Documentation","colors":{"primary":"#0C8376","light":"#15B79E","dark":"#107569"},"logo":{"light":"https://mintcdn.com/msportal/KnbwIXtZSTlVJTt6/logo/light.svg?fit=max\u0026auto=format\u0026n=KnbwIXtZSTlVJTt6\u0026q=85\u0026s=eb69f6d6bf16b2c401770aef19ade1d2","dark":"https://mintcdn.com/msportal/KnbwIXtZSTlVJTt6/logo/dark.svg?fit=max\u0026auto=format\u0026n=KnbwIXtZSTlVJTt6\u0026q=85\u0026s=03f8df7191e7a8ea7da084df57f6107f"},"favicon":"https://mintcdn.com/msportal/KjsKytvp08K0bejm/favicon-16x16.png?fit=max\u0026auto=format\u0026n=KjsKytvp08K0bejm\u0026q=85\u0026s=378df7f039bbff7885231fec799d29ac","navbar":{"links":[{"href":"/release-notes/roadmap","label":"Roadmap"},{"href":"mailto:support@msportal.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.msportal.ai"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/msportal"},"links":[{"header":"Resources","items":[{"label":"MSPortal.ai","href":"https://msportal.ai"},{"label":"Support","href":"mailto:support@msportal.ai"},{"label":"Status","href":"https://status.msportal.ai"}]}]},"fonts":{"family":"Inter"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"msportal","hasAudioNarration":false,"actualSubdomain":"msportal","customDomains":["docs.msportal.ai"],"gitSource":{"type":"github","owner":"msportal-ai","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6af75ae5643517979ab0f116","clientVersion":"0.0.4131","searchFilterCounts":[{"language":"default","tag":"MSP Guides","count":470},{"language":"default","tag":"API Reference","count":433},{"language":"default","tag":"Operations","count":126},{"language":"default","tag":"Planning","count":101},{"language":"default","tag":"Integrations","count":95},{"language":"default","tag":"Projects","count":75},{"language":"default","tag":"Protection","count":59},{"language":"default","tag":"Standards","count":56},{"language":"default","tag":"Client Onboarding","count":48},{"language":"default","tag":"Compliance","count":45}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#page-title{font-size:1.75rem;line-height:2.125rem}#header .prose.text-lg{font-size:1rem;line-height:1.5rem;color:rgb(var(--gray-500))}#content-area .prose{font-size:0.9375rem;line-height:1.6}#content-area .mdx-content{margin-top:1.5rem}#content-area .mdx-content h2{font-size:1.25rem;line-height:1.75rem;margin-top:2.25rem;margin-bottom:0.75rem}#content-area .mdx-content h3{font-size:1.0625rem;line-height:1.5rem;margin-top:1.75rem;margin-bottom:0.5rem}#content-area .mdx-content li{margin-top:0.25em;margin-bottom:0.25em}#content-area .steps{margin-top:1rem}#content-area .step{padding-bottom:0.75rem}#content-area [data-component-part=\"step-title\"]{margin-top:0.25rem;margin-bottom:0.375rem}#content-area [data-component-part=\"accordion-content\"] td,#content-area [data-component-part=\"accordion-content\"] th{min-width:0}@media (max-width: 639px){#content-area [data-component-part=\"accordion-content\"] td:last-child{min-width:16rem}}#content-area [data-table-wrapper]>[data-component-part=\"scroll-area-viewport\"]{-webkit-mask-image:linear-gradient(\n to right,\n transparent 0,\n black min(var(--scroll-area-fade-size), var(--scroll-area-overflow-x-start, 0px)),\n black calc(100% - min(var(--scroll-area-fade-size), var(--scroll-area-overflow-x-end, 0px))),\n transparent 100%\n );mask-image:linear-gradient(\n to right,\n transparent 0,\n black min(var(--scroll-area-fade-size), var(--scroll-area-overflow-x-start, 0px)),\n black calc(100% - min(var(--scroll-area-fade-size), var(--scroll-area-overflow-x-end, 0px))),\n transparent 100%\n )}#content-area [data-table-wrapper]>[data-component-part=\"scroll-area-scrollbar\"][data-has-overflow-x]{opacity:1;pointer-events:auto}#sidebar-content li>a,#sidebar-content li>button{font-size:0.875rem;line-height:1.25rem;padding-top:0.3125rem;padding-bottom:0.3125rem}#sidebar-content li>a span{hyphens:manual}#sidebar-content a.nav-anchor{margin-bottom:0.25rem;font-size:0.875rem}#sidebar-content ul:has(>li>a.nav-anchor){margin-bottom:1rem;padding-bottom:0.5rem;border-bottom:1px solid rgb(var(--gray-100))}.dark #sidebar-content ul:has(>li>a.nav-anchor){border-bottom-color:rgb(255 255 255 / 0.1)}#table-of-contents{font-size:0.8125rem;line-height:1.25rem}#sidebar-content li>a>div:first-child:has(>svg,>img){display:none}:root{--sidebar-width: 16rem}@media (min-width: 1024px){#navbar .max-w-8xl,#body-content{max-width:none}#content-container{max-width:88rem;margin-left:0;padding-left:2.5rem;padding-right:2rem;column-gap:2.5rem;justify-content:space-between}}@media (min-width: 1280px){#content-area{width:calc(100% - 16.5rem);max-width:52rem;margin-left:0}#navbar.is-wide~#body-content #content-container{max-width:none}#navbar.is-wide~#body-content #content-area{width:100%;max-width:none}#table-of-contents-layout{width:14rem;padding-left:0}#table-of-contents{width:14rem}}.roadmap-embed{display:block;border:0;background:transparent;color-scheme:light}.dark .roadmap-embed{color-scheme:dark}#content-area img[width=\"390\"],#content-area img[width=\"780\"]{width:100%!important;max-width:300px!important;height:auto!important;margin-left:auto;margin-right:auto}"}],"page":{"pagePath":"user-guides/settings/companies","slug":"/user-guides/settings/companies","pageMetadata":{"title":"Companies Settings","description":"Create and maintain client companies, run bulk actions on many companies, and find user and team administration.","icon":"building","href":"/user-guides/settings/companies"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create and maintain client companies, run bulk actions on many companies, and find user and team administration.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Frame,Heading,Note,OptimizedImage,Step,Steps,Table,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Companies Settings is where MSP staff create client companies, edit their details, import them from your PSA and change many companies at once. Client users and roles live in `,_jsx(_components.strong,{children:`Settings > Users \u0026 Roles`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`You need Companies settings access. Read access lets you view companies. Write access lets you add, edit and run bulk actions. Manage access is also needed to delete companies, turn `,_jsx(_components.strong,{children:`AI Home`}),` or a company’s `,_jsx(_components.strong,{children:`AI`}),` on or off, and open `,_jsx(_components.strong,{children:`Blocked Companies`}),` and `,_jsx(_components.strong,{children:`Hardware defaults`}),`.`]}),`\n`,_jsx(_components.li,{children:`Premium Training actions need the Training manage permission.`}),`\n`,_jsxs(_components.li,{children:[`To import companies, connect a supported PSA first. See `,_jsx(_components.a,{href:`/user-guides/integrations/import-companies`,children:`Import Companies`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`New from import`}),` also needs `,_jsx(_components.strong,{children:`Integration Company Mapping`}),` write access, because the new company is linked to its PSA record.`]}),`\n`,_jsx(_components.li,{children:`Company users cannot use this page.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`find-a-company`,children:`Find a company`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Companies`,children:_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Settings > Companies`}),`.`]})}),_jsx(Step,{title:`Filter the list`,children:_jsxs(_components.p,{children:[`Use the column filters. `,_jsx(_components.strong,{children:`Company`}),` searches by name. `,_jsx(_components.strong,{children:`Status`}),`, `,_jsx(_components.strong,{children:`Training`}),` (`,_jsx(_components.strong,{children:`Premium`}),` or `,_jsx(_components.strong,{children:`Standard`}),`) and `,_jsx(_components.strong,{children:`M365`}),` (`,_jsx(_components.strong,{children:`Connected`}),` or `,_jsx(_components.strong,{children:`Not Set`}),`) are lists. `,_jsx(_components.strong,{children:`Integrations`}),` and `,_jsx(_components.strong,{children:`Types`}),` let you pick several values. The `,_jsx(_components.strong,{children:`Industry`}),` column is hidden until you turn it on from the column menu.`]})}),_jsx(Step,{title:`Check badges before editing`,children:_jsxs(_components.p,{children:[`A `,_jsx(_components.strong,{children:`Parent`}),` or `,_jsx(_components.strong,{children:`Child`}),` badge shows the company hierarchy. `,_jsx(_components.strong,{children:`Imported from`}),` shows the PSA that created the company. Similar names can be different companies, so check the badges first.`]})})]}),`\n`,_jsxs(_components.p,{children:[`Each row has a `,_jsx(_components.strong,{children:`…`}),` menu. With write access it shows `,_jsx(_components.strong,{children:`Edit Company`}),`. With read access only, it shows `,_jsx(_components.strong,{children:`View Details \u0026 Users`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`create-a-company`,children:`Create a company`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the form`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`New Company`}),` in the page header, then `,_jsx(_components.strong,{children:`Blank company`}),`. The `,_jsx(_components.strong,{children:`Add New Company`}),` dialog opens. `,_jsx(_components.strong,{children:`New from import`}),` is listed too when a supported PSA is connected and your role can import companies.`]})}),_jsx(Step,{title:`Enter the details`,children:_jsxs(_components.p,{children:[`Enter the required `,_jsx(_components.strong,{children:`Name`}),`. Add `,_jsx(_components.strong,{children:`Contact Name`}),`, `,_jsx(_components.strong,{children:`Contact Email`}),`, `,_jsx(_components.strong,{children:`Contact Phone`}),`, `,_jsx(_components.strong,{children:`Website`}),`, `,_jsx(_components.strong,{children:`Industry`}),`, `,_jsx(_components.strong,{children:`Company Size`}),` and `,_jsx(_components.strong,{children:`Primary Domain`}),` as needed.`]})}),_jsx(Step,{title:`Scroll to the rest of the form`,children:_jsxs(_components.p,{children:[`Below the contact fields, set the `,_jsx(_components.strong,{children:`Address`}),`, `,_jsx(_components.strong,{children:`Active`}),`, `,_jsx(_components.strong,{children:`Compliance Schedule`}),`, `,_jsx(_components.strong,{children:`Business Review Schedule`}),` and `,_jsx(_components.strong,{children:`Year-end Date`}),`.`]})}),_jsx(Step,{title:`Save`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Save Company`}),`. A message confirms the company was created. `,_jsx(_components.strong,{children:`Cancel`}),` closes the form without saving.`]})})]}),`\n`,_jsx(Frame,{caption:`The top of the Add New Company form. The address, active state and schedule fields continue below, and Save Company is in the dialog footer.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/msportal/LUe1Ix2pDHU7mVmf/images/product/company-create-contact-fields.png?fit=max\u0026auto=format\u0026n=LUe1Ix2pDHU7mVmf\u0026q=85\u0026s=8190e0e6a467bd93ab04a2655bf89d65`,alt:`Blank Add New Company form showing the required name and optional contact and website fields.`,width:`1200`,height:`720`,\"data-og-width\":`1200`,\"data-og-height\":`720`,\"data-path\":`images/product/company-create-contact-fields.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/msportal/LUe1Ix2pDHU7mVmf/images/product/company-create-contact-fields.png?w=280\u0026fit=max\u0026auto=format\u0026n=LUe1Ix2pDHU7mVmf\u0026q=85\u0026s=35babc2f58e11faef98f0fe6a50e938d 280w, https://mintcdn.com/msportal/LUe1Ix2pDHU7mVmf/images/product/company-create-contact-fields.png?w=560\u0026fit=max\u0026auto=format\u0026n=LUe1Ix2pDHU7mVmf\u0026q=85\u0026s=76fc9fb04dbfb1aca3d6e829395c0def 560w, https://mintcdn.com/msportal/LUe1Ix2pDHU7mVmf/images/product/company-create-contact-fields.png?w=840\u0026fit=max\u0026auto=format\u0026n=LUe1Ix2pDHU7mVmf\u0026q=85\u0026s=3796635477df64c339151f0230229b31 840w, https://mintcdn.com/msportal/LUe1Ix2pDHU7mVmf/images/product/company-create-contact-fields.png?w=1100\u0026fit=max\u0026auto=format\u0026n=LUe1Ix2pDHU7mVmf\u0026q=85\u0026s=caf865bc75444c90c5176723c2ba1d2f 1100w, https://mintcdn.com/msportal/LUe1Ix2pDHU7mVmf/images/product/company-create-contact-fields.png?w=1650\u0026fit=max\u0026auto=format\u0026n=LUe1Ix2pDHU7mVmf\u0026q=85\u0026s=40512632d16525f1e257a73309558bc3 1650w, https://mintcdn.com/msportal/LUe1Ix2pDHU7mVmf/images/product/company-create-contact-fields.png?w=2500\u0026fit=max\u0026auto=format\u0026n=LUe1Ix2pDHU7mVmf\u0026q=85\u0026s=e551e9e5f5a674d411f18ce399f9b384 2500w`})}),`\n`,_jsxs(_components.p,{children:[`A contact email on a company does not create a portal user or send an invitation. The `,_jsx(_components.strong,{children:`Compliance Schedule`}),` and `,_jsx(_components.strong,{children:`Business Review Schedule`}),` fields set meeting frequency. They are separate from `,_jsx(_components.a,{href:`/user-guides/settings/compliance-schedules`,children:`automated compliance run schedules`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`create-a-company-from-your-psa`,children:`Create a company from your PSA`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.strong,{children:`New from import`}),` to bring one client in from your PSA and link it to your other tools in the same dialog. It works with Halo, ConnectWise, Autotask, Syncro and ConnectWise Asio.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open New from import`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`New Company`}),` in the page header, then `,_jsx(_components.strong,{children:`New from import`}),`.`]})}),_jsx(Step,{title:`Pick the PSA company`,children:_jsxs(_components.p,{children:[`If you have more than one PSA connected, choose it in `,_jsx(_components.strong,{children:`Import from`}),`. The list shows only that PSA’s companies that aren’t in MSPortal yet, with their type. Search to narrow it, select one company, and click `,_jsx(_components.strong,{children:`Import and continue`}),`. A message confirms the company was created.`]})}),_jsx(Step,{title:`Review the matches`,children:_jsxs(_components.p,{children:[`MSPortal checks your other connected tools, such as your RMM, backup and documentation tools, for records that match the new company. It uses the same matching as `,_jsx(_components.strong,{children:`Review likely matches`}),` in `,_jsx(_components.a,{href:`/user-guides/settings/integration-company-mapping#review-likely-matches`,children:`Integration Company Mapping`}),`. Each match shows the tool, the record and a confidence score, and every match starts checked. Uncheck any that belong to a different client.`]})}),_jsx(Step,{title:`Link or skip`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Link`}),` (the button shows the count, such as `,_jsx(_components.strong,{children:`Link 3 matches`}),`) to link the checked records and close the dialog. Click `,_jsx(_components.strong,{children:`Skip`}),` to finish without linking. `,_jsx(_components.strong,{children:`Open company`}),` goes to the new company’s page.`]})})]}),`\n`,_jsx(Frame,{caption:`New Company in the page header offers a blank company or one imported from your PSA.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-company-menu.png?fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=f0fae0e24cec801aacbe89defbfaae7c`,alt:`New Company menu open on Settings > Companies with Blank company and New from import options`,width:`1382`,height:`266`,\"data-og-width\":`1382`,\"data-og-height\":`266`,\"data-path\":`images/product/company-new-company-menu.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-company-menu.png?w=280\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=d6385cf14380ca50df3e455eedd2461b 280w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-company-menu.png?w=560\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=f382c85a7b0d8ebba8a8339a161d6649 560w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-company-menu.png?w=840\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=44d2527d6976a090b83c96f24a8f536d 840w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-company-menu.png?w=1100\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=f158b216630b8a4029e00751427c6524 1100w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-company-menu.png?w=1650\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=b052126e80652c90f0b742579b1506c9 1650w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-company-menu.png?w=2500\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=7355d4a36c2c8757b03ef5ae08f1787c 2500w`})}),`\n`,_jsx(Frame,{caption:`Pick the PSA company to create. Only companies that aren't in MSPortal yet are listed.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-from-import-pick.png?fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=efa7fe3a45c6af1b00e2be0c7abb9767`,alt:`New company from import dialog with Import from set to Autotask PSA, a search field, and a list of PSA companies with their types, one selected`,width:`1309`,height:`1537`,\"data-og-width\":`1309`,\"data-og-height\":`1537`,\"data-path\":`images/product/company-new-from-import-pick.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-from-import-pick.png?w=280\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=d5dcb0ddf0268c504892311f11d0f5be 280w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-from-import-pick.png?w=560\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=eb7149e1f80758fc4f63192cdcccfd99 560w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-from-import-pick.png?w=840\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=67c2c5c2cfeea97bd56110e55345e635 840w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-from-import-pick.png?w=1100\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=294b5da92bfd4adab8d3eca2cfab520a 1100w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-from-import-pick.png?w=1650\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=cd72aad1b157cdafb3f0050549144c95 1650w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-from-import-pick.png?w=2500\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=aeb50c74d250399a46d1906aebadd32e 2500w`})}),`\n`,_jsx(Frame,{caption:`When nothing in your other tools matches, link the company later from Integration Company Mapping.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-from-import-no-matches.png?fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=dc28c1f01ba20cfc8c1d9bdd7d6372e1`,alt:`Link step of New from import saying there are no matches for A1 Facilities Management in the other integrations, with Open company and Done buttons`,width:`1294`,height:`602`,\"data-og-width\":`1294`,\"data-og-height\":`602`,\"data-path\":`images/product/company-new-from-import-no-matches.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-from-import-no-matches.png?w=280\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=9eea54e709496b29227ec897f7287150 280w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-from-import-no-matches.png?w=560\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=d477c1bba937434fe8b4fda78e7af66f 560w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-from-import-no-matches.png?w=840\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=d6106ff814531c54ac7899a52943fb6b 840w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-from-import-no-matches.png?w=1100\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=93de3cbd2629a26832820cf9759f64e5 1100w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-from-import-no-matches.png?w=1650\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=45021df1319841fb99627ef56ce39217 1650w, https://mintcdn.com/msportal/wB1Eat6CojI2m0cz/images/product/company-new-from-import-no-matches.png?w=2500\u0026fit=max\u0026auto=format\u0026n=wB1Eat6CojI2m0cz\u0026q=85\u0026s=fadf726565577298a086915c453822af 2500w`})}),`\n`,_jsxs(_components.p,{children:[`Matching only suggests records that aren’t linked to any company yet, and skips tools where the new company already has a link, such as the PSA it came from. Each tool offers its best match. A record that matches an existing company better stays with that company. Link it by hand in `,_jsx(_components.a,{href:`/user-guides/settings/integration-company-mapping`,children:`Integration Company Mapping`}),` if it belongs to the new one.`]}),`\n`,_jsx(_components.p,{children:`If the company is inactive in your PSA, it’s created as inactive and the dialog says so. Activate it on its page, then link its tools from Integration Company Mapping.`}),`\n`,_jsx(Heading,{level:`2`,id:`edit-a-company`,children:`Edit a company`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the company`,children:_jsxs(_components.p,{children:[`In the list, open the row’s `,_jsx(_components.strong,{children:`…`}),` menu and click `,_jsx(_components.strong,{children:`Edit Company`}),`. The company page opens on the `,_jsx(_components.strong,{children:`Overview`}),` tab.`]})}),_jsx(Step,{title:`Edit a field`,children:_jsxs(_components.p,{children:[`Point at a field and click the pencil icon. Change the value, then click the check mark to save, or the `,_jsx(_components.strong,{children:`X`}),` to cancel. Each field saves on its own.`]})}),_jsxs(Step,{title:`Open another tab`,children:[_jsx(_components.p,{children:`Use the tabs at the top to work on the rest of the company. Each tab saves separately.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tab`}),_jsx(_components.th,{children:`What you do there`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Overview`})}),_jsxs(_components.td,{children:[`Edit contact, address, industry, language, currency, time zone, size, parent company, types, schedules, year-end date, `,_jsx(_components.strong,{children:`Compliance Required`}),` and custom fields. See the PSA, Microsoft 365 and device integration cards`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Users`})}),_jsxs(_components.td,{children:[`View and manage this company’s users. See `,_jsx(_components.a,{href:`/user-guides/settings/change-company-user-permissions`,children:`Change a Company user’s permissions`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Locations`})}),_jsx(_components.td,{children:`Add, edit, duplicate or delete physical locations, or import sites from your PSA. Changes here stay in MSPortal and never reach your PSA`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Defaults`})}),_jsxs(_components.td,{children:[`Set company defaults on the `,_jsx(_components.strong,{children:`Recurring meeting defaults`}),`, `,_jsx(_components.strong,{children:`Import`}),`, `,_jsx(_components.strong,{children:`Communication`}),`, `,_jsx(_components.strong,{children:`Hardware`}),`, `,_jsx(_components.strong,{children:`Software`}),`, `,_jsx(_components.strong,{children:`Location`}),`, `,_jsx(_components.strong,{children:`Security`}),` and `,_jsx(_components.strong,{children:`Tickets`}),` sub-tabs. Click `,_jsx(_components.strong,{children:`Save Defaults`}),` to save`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Ticketing`})}),_jsxs(_components.td,{children:[`Set the default PSA routing for this company’s tickets and choose which ticket templates are available to it. For a template with branches, choose the version this company uses: `,_jsx(_components.strong,{children:`Main form`}),`, a branch, or `,_jsx(_components.strong,{children:`Off`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Team`})}),_jsx(_components.td,{children:`Assign MSP staff to this company’s team roles`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Notes`})}),_jsx(_components.td,{children:`Keep account notes and the QBR log`})]})]})]}),_jsxs(Note,{children:[`In `,_jsx(_components.strong,{children:`Defaults > Recurring meeting defaults`}),`, Quarterly and Yearly meetings can also use `,_jsx(_components.strong,{children:`Target month or quarter`}),`. It sets the first occurrence of new bookings and is independent of `,_jsx(_components.strong,{children:`Suggest a schedule`}),`. Click `,_jsx(_components.strong,{children:`Save Defaults`}),` to keep the target; existing bookings keep their dates. See `,_jsx(_components.a,{href:`/user-guides/calendar/recurring-meeting-booking`,children:`Recurring Meeting Booking`}),`.`]})]})]}),`\n`,_jsx(_components.p,{children:`If a value changes back after a sync, your PSA owns that field. Change it in the PSA.`}),`\n`,_jsx(Heading,{level:`3`,id:`add-a-location`,children:`Add a location`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the company menu`,children:_jsxs(_components.p,{children:[`In the company list, open the row’s `,_jsx(_components.strong,{children:`…`}),` menu and click `,_jsx(_components.strong,{children:`Add Location`}),`. You can also use `,_jsx(_components.strong,{children:`Add`}),` on the `,_jsx(_components.strong,{children:`Locations`}),` tab.`]})}),_jsx(Step,{title:`Fill in the dialog`,children:_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Create New Location`}),`, enter the `,_jsx(_components.strong,{children:`Name`}),` and the address, phone, email and notes you want.`]})}),_jsx(Step,{title:`Create it`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Create Location`}),`.`]})})]}),`\n`,_jsx(Warning,{children:`Locations never sync back to your PSA. A location you add, edit or delete in MSPortal changes only MSPortal; ConnectWise, Autotask, Halo and other PSAs keep their own sites. To change a site in your PSA, change it there. Locations imported from your PSA update on its next sync, which replaces any edits made to them in MSPortal.`}),`\n`,_jsx(_components.p,{children:`A parent company and a location are different things. A location is a physical site of one company.`}),`\n`,_jsx(Heading,{level:`2`,id:`import-companies`,children:`Import companies`}),`\n`,_jsxs(_components.p,{children:[`To bring in a single company and link its tools in one step, use `,_jsx(_components.a,{href:`#create-a-company-from-your-psa`,children:`New from import`}),`. Use `,_jsx(_components.strong,{children:`Import`}),` for several companies at once.`]}),`\n`,_jsxs(Note,{children:[`In the import dialog, `,_jsx(_components.strong,{children:`Quick Match`}),`, bulk `,_jsx(_components.strong,{children:`Assign`}),`, filter counts and `,_jsx(_components.strong,{children:`Clear Filters`}),` share one toolbar. On a phone, open `,_jsx(_components.strong,{children:`Filters`}),` to search.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the Import menu`,children:_jsxs(_components.p,{children:[`On `,_jsx(_components.strong,{children:`Settings > Companies`}),`, click `,_jsx(_components.strong,{children:`Import`}),` in the page header. It shows only when a supported PSA is connected.`]})}),_jsx(Step,{title:`Choose the provider`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Import from`}),` and your provider’s name. The import dialog opens.`]})}),_jsx(Step,{title:`Select and import`,children:_jsxs(_components.p,{children:[`Pick the companies to import. You can link each one to an existing company or create a new one. Follow `,_jsx(_components.a,{href:`/user-guides/integrations/import-companies`,children:`Import Companies`}),`.`]})})]}),`\n`,_jsxs(_components.p,{children:[`Check `,_jsx(_components.a,{href:`/user-guides/settings/integration-company-mapping`,children:`Integration Company Mapping`}),` before you create a company that may already exist. Some selections create the company before the link is applied, and `,_jsx(_components.strong,{children:`Cancel`}),` does not undo them.`]}),`\n`,_jsx(Heading,{level:`2`,id:`run-a-bulk-action`,children:`Run a bulk action`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Select companies`,children:_jsx(_components.p,{children:`Tick the checkbox on each company. To include companies on other pages, choose all matching companies across pages.`})}),_jsx(Step,{title:`Open the Actions menu`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Actions (count)`}),` in the page header. The count shows how many companies are selected, or `,_jsx(_components.strong,{children:`All N`}),` for a cross-page selection.`]})}),_jsx(Step,{title:`Choose the action and confirm`,children:_jsx(_components.p,{children:`Pick an action from the table below. Check the dialog’s company list before you click its apply button.`})})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Action`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Assign Teams to Selected`})}),_jsx(_components.td,{children:`Assigns or unassigns team roles for users across the selected companies. Changes apply immediately`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Set Parent Company`})}),_jsxs(_components.td,{children:[`Makes the selected companies children of another company. A company cannot be its own parent or the parent of its own ancestor. Choose `,_jsx(_components.strong,{children:`No parent company`}),` to remove the relationship. Click `,_jsx(_components.strong,{children:`Update Parent`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Manage Types`})}),_jsxs(_components.td,{children:[`Adds, removes or replaces company types. See `,_jsx(_components.a,{href:`#manage-company-types`,children:`Manage company types`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Set Language`})}),_jsxs(_components.td,{children:[`Sets a default language for the selected companies. `,_jsx(_components.strong,{children:`Clear Override`}),` returns them to the tenant default. Click `,_jsx(_components.strong,{children:`Apply`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Set Currency`})}),_jsxs(_components.td,{children:[`Sets a currency for the selected companies. `,_jsx(_components.strong,{children:`Clear Override`}),` returns them to the tenant default. Click `,_jsx(_components.strong,{children:`Apply`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Edit Custom Field`})}),_jsxs(_components.td,{children:[`Sets one custom field to the same value on every selected company. See `,_jsx(_components.a,{href:`#set-a-custom-field-on-many-companies`,children:`Set a custom field on many companies`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Set Meeting Schedules`})}),_jsxs(_components.td,{children:[`Sets `,_jsx(_components.strong,{children:`Business reviews`}),` and `,_jsx(_components.strong,{children:`Compliance reviews`}),` frequency. `,_jsx(_components.strong,{children:`Keep existing`}),` leaves a schedule alone. `,_jsx(_components.strong,{children:`No schedule`}),` removes it. Click `,_jsx(_components.strong,{children:`Apply schedules`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Enable Premium Training`}),` / `,_jsx(_components.strong,{children:`Disable Premium Training`})]}),_jsx(_components.td,{children:`Turns Premium Training on or off at once. Needs the Training manage permission`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Enable AI Home`}),` / `,_jsx(_components.strong,{children:`Disable AI Home`})]}),_jsx(_components.td,{children:`Turns AI Home on or off at once. Needs manage access`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Turn off AI`}),` / `,_jsx(_components.strong,{children:`Turn on AI`})]}),_jsxs(_components.td,{children:[`Stops or allows every AI feature for the selected companies. See `,_jsx(_components.a,{href:`#turn-off-ai-for-a-company`,children:`Turn off AI for a company`}),`. Needs manage access`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Delete Selected`})}),_jsx(_components.td,{children:`Permanently deletes the selected companies. Needs manage access`})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Enable and Disable Premium Training`}),`, `,_jsx(_components.strong,{children:`Enable and Disable AI Home`}),` and `,_jsx(_components.strong,{children:`Turn off AI`}),` / `,_jsx(_components.strong,{children:`Turn on AI`}),` apply as soon as you click them, with no confirmation dialog. Training availability, user overrides and enrollment are separate settings. See `,_jsx(_components.a,{href:`/user-guides/training/enabling-training`,children:`Enable Training`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`turn-off-ai-for-a-company`,children:`Turn off AI for a company`}),`\n`,_jsx(_components.p,{children:`Use this when a client must not have any of its data used by AI, for example because its contract or its own policy forbids it. Your other companies keep AI.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the company`,children:_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Settings > Companies`}),`, open the company. On the `,_jsx(_components.strong,{children:`Overview`}),` tab, find the `,_jsx(_components.strong,{children:`AI`}),` card.`]})}),_jsx(Step,{title:`Turn off Use AI with this company's data`,children:_jsxs(_components.p,{children:[`The change saves right away. To change several companies at once, select them in the list and choose `,_jsx(_components.strong,{children:`Turn off AI`}),` from the `,_jsx(_components.strong,{children:`Actions`}),` menu, or use `,_jsx(_components.strong,{children:`Turn off AI`}),` in a row’s `,_jsx(_components.strong,{children:`…`}),` menu.`]})})]}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`AI`}),` column in the company list shows `,_jsx(_components.strong,{children:`Off`}),` for every company with AI turned off.`]}),`\n`,_jsx(_components.p,{children:`While AI is off for a company:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`None of its data is sent to an AI model. The assistant, its tools, RON, the Chrome extension and MCP clients cannot see the company or any of its records, even when you ask about all companies.`}),`\n`,_jsx(_components.li,{children:`AI reports for it are blocked: AI narrative reports, report presentations, AI report editing and AI sections of scheduled reports. Reports without AI still run.`}),`\n`,_jsx(_components.li,{children:`Ticket AI, meeting summaries, planner and compliance note drafts, survey analysis and other AI features refuse the company, or leave it out when they cover many companies.`}),`\n`,_jsxs(_components.li,{children:[`Background AI jobs skip it, including feedback triage and automation `,_jsx(_components.strong,{children:`AI Transform`}),` steps.`]}),`\n`,_jsxs(_components.li,{children:[`Its company users see no AI features, the same as when `,_jsx(_components.strong,{children:`Enable AI features for client users`}),` is off in `,_jsx(_components.a,{href:`/user-guides/settings/tenant#configure-ai-features`,children:`Tenant Settings`}),`.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`While any company has AI off:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Assistant conversations that started before AI was turned off start fresh, so earlier answers about that company are never reused.`}),`\n`,_jsx(_components.li,{children:`Searching all companies from the assistant needs a company selection. Pick the companies you want in the company selector.`}),`\n`,_jsx(_components.li,{children:`AI standards suggestions are unavailable.`}),`\n`,_jsx(_components.li,{children:`A survey’s overall analysis and sentiment cover only the answers from companies with AI on.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Turning AI back on takes effect right away. Nothing is deleted while AI is off.`}),`\n`,_jsx(Heading,{level:`2`,id:`manage-company-types`,children:`Manage company types`}),`\n`,_jsxs(_components.p,{children:[`Types group companies for filters, reports and ticket-template availability. A company can have several types. `,_jsx(_components.strong,{children:`Manual`}),` types are created in MSPortal. `,_jsx(_components.strong,{children:`PSA-synced`}),` types come from your PSA and show a tooltip, `,_jsx(_components.strong,{children:`Synced from`}),` and the provider name.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Select the companies`,children:_jsx(_components.p,{children:`Tick the companies. Use the column filters first to narrow the list.`})}),_jsx(Step,{title:`Open Manage Types`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Actions (count)`}),`, then `,_jsx(_components.strong,{children:`Manage Types`}),`. For one company, use `,_jsx(_components.strong,{children:`Manage Types`}),` in its row menu. The `,_jsx(_components.strong,{children:`Manage Company Types`}),` dialog opens.`]})}),_jsxs(Step,{title:`Choose an action`,children:[_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Action`}),`, pick one option.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Option`}),_jsx(_components.th,{children:`Result`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Add types (keep existing)`})}),_jsx(_components.td,{children:`Adds the types you pick to each company`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Replace all types`})}),_jsx(_components.td,{children:`Replaces each company’s manual types with the ones you pick. PSA-synced types stay`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Remove types`})}),_jsx(_components.td,{children:`Removes the types you pick. The list shows only types on the selected companies`})]})]})]})]}),_jsx(Step,{title:`Pick or create types`,children:_jsxs(_components.p,{children:[`Pick existing types, or type a new name and click `,_jsx(_components.strong,{children:`Create type`}),`. A new type is saved right away. Cancelling the dialog does not delete it.`]})}),_jsx(Step,{title:`Apply`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Apply`}),`. A message says how many companies changed. Check the `,_jsx(_components.strong,{children:`Types`}),` column.`]})})]}),`\n`,_jsx(_components.p,{children:`Removed types stay removed. Your PSA sync does not add them back unless you add the type again.`}),`\n`,_jsx(Heading,{level:`2`,id:`set-a-custom-field-on-many-companies`,children:`Set a custom field on many companies`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.strong,{children:`Edit Custom Field`}),` to give one company custom field the same value on many companies. For example, set the same contract renewal date for a group of clients.`]}),`\n`,_jsx(Heading,{level:`3`,id:`before-you-start-2`,children:`Before you start`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`You need write access to Companies settings, and your MSPortal billing must be active.`}),`\n`,_jsxs(_components.li,{children:[`Create the field first. Open `,_jsx(_components.strong,{children:`Settings > Customization > Fields`}),`, choose `,_jsx(_components.strong,{children:`Companies`}),`, and save the field. See `,_jsx(_components.a,{href:`/user-guides/settings/custom-fields`,children:`Custom Fields`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`A `,_jsx(_components.strong,{children:`Dropdown`}),`, `,_jsx(_components.strong,{children:`Multi-Select`}),` or `,_jsx(_components.strong,{children:`Radio Buttons`}),` field appears only after it has at least one saved option.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`set-the-value`,children:`Set the value`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Select the companies`,children:_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Settings > Companies`}),`, tick the checkbox beside each company. To include companies on other pages, select all matching companies across pages.`]})}),_jsx(Step,{title:`Open Edit Custom Field`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Actions (count)`}),`, then `,_jsx(_components.strong,{children:`Edit Custom Field`}),`.`]})}),_jsx(Step,{title:`Check the selected companies`,children:_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Selected Companies`}),` list shows the first 30 names, then a `,_jsx(_components.strong,{children:`+N more`}),` badge. Close the dialog and adjust your selection if a company is wrong.`]})}),_jsx(Step,{title:`Choose the field and value`,children:_jsxs(_components.p,{children:[`Choose a field under `,_jsx(_components.strong,{children:`Custom field`}),`. Then enter the `,_jsx(_components.strong,{children:`Value`}),`. The input matches the field type, such as a date picker for a date field or a list for a dropdown.`]})}),_jsx(Step,{title:`Apply the value`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Apply`}),`. A message confirms how many companies were updated, and the selection clears.`]})})]}),`\n`,_jsx(Frame,{caption:`Edit Custom Field in the Actions menu for one selected company.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/msportal/0zQdy91LsYHrBbny/images/product/companies-bulk-custom-field-menu-branch-preview.png?fit=max\u0026auto=format\u0026n=0zQdy91LsYHrBbny\u0026q=85\u0026s=ac91b3c9f39ee23ca6baa5f267de592a`,alt:`Actions menu on Settings > Companies with Edit Custom Field listed below Set Currency, and one Example company selected`,width:`2304`,height:`1160`,\"data-og-width\":`2304`,\"data-og-height\":`1160`,\"data-path\":`images/product/companies-bulk-custom-field-menu-branch-preview.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/msportal/0zQdy91LsYHrBbny/images/product/companies-bulk-custom-field-menu-branch-preview.png?w=280\u0026fit=max\u0026auto=format\u0026n=0zQdy91LsYHrBbny\u0026q=85\u0026s=016d5c809b995bfa3b4f597d21ee34fd 280w, https://mintcdn.com/msportal/0zQdy91LsYHrBbny/images/product/companies-bulk-custom-field-menu-branch-preview.png?w=560\u0026fit=max\u0026auto=format\u0026n=0zQdy91LsYHrBbny\u0026q=85\u0026s=374f64a95edbdcfcec19e81eb9a3d5f5 560w, https://mintcdn.com/msportal/0zQdy91LsYHrBbny/images/product/companies-bulk-custom-field-menu-branch-preview.png?w=840\u0026fit=max\u0026auto=format\u0026n=0zQdy91LsYHrBbny\u0026q=85\u0026s=d09fbda3e96b0e4c29f53c6e1239cd2c 840w, https://mintcdn.com/msportal/0zQdy91LsYHrBbny/images/product/companies-bulk-custom-field-menu-branch-preview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=0zQdy91LsYHrBbny\u0026q=85\u0026s=eaa930c496aa860135e683bf934208b3 1100w, https://mintcdn.com/msportal/0zQdy91LsYHrBbny/images/product/companies-bulk-custom-field-menu-branch-preview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=0zQdy91LsYHrBbny\u0026q=85\u0026s=b23a57c5f7c7ca6701db0ab36d05bfdf 1650w, https://mintcdn.com/msportal/0zQdy91LsYHrBbny/images/product/companies-bulk-custom-field-menu-branch-preview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=0zQdy91LsYHrBbny\u0026q=85\u0026s=94b766694d826657dfd8c8b8b0e4c994 2500w`})}),`\n`,_jsx(Frame,{caption:`The Edit Custom Field dialog with a required date field and a value chosen. Clear Value is unavailable because the field is required.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/msportal/0zQdy91LsYHrBbny/images/product/companies-bulk-custom-field-dialog-branch-preview.png?fit=max\u0026auto=format\u0026n=0zQdy91LsYHrBbny\u0026q=85\u0026s=e7574d0871f693ee0ac31f5c11b2f3ec`,alt:`Edit Custom Field dialog with Contract Renewal Date selected, Sep 29, 2026 as the value, a disabled Clear Value button, and Cancel and Apply buttons`,width:`1000`,height:`868`,\"data-og-width\":`1000`,\"data-og-height\":`868`,\"data-path\":`images/product/companies-bulk-custom-field-dialog-branch-preview.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/msportal/0zQdy91LsYHrBbny/images/product/companies-bulk-custom-field-dialog-branch-preview.png?w=280\u0026fit=max\u0026auto=format\u0026n=0zQdy91LsYHrBbny\u0026q=85\u0026s=e105a6ede65a2d7e3007986ddea7f312 280w, https://mintcdn.com/msportal/0zQdy91LsYHrBbny/images/product/companies-bulk-custom-field-dialog-branch-preview.png?w=560\u0026fit=max\u0026auto=format\u0026n=0zQdy91LsYHrBbny\u0026q=85\u0026s=5883cc12445b7a60959fe6a27da0cb8a 560w, https://mintcdn.com/msportal/0zQdy91LsYHrBbny/images/product/companies-bulk-custom-field-dialog-branch-preview.png?w=840\u0026fit=max\u0026auto=format\u0026n=0zQdy91LsYHrBbny\u0026q=85\u0026s=2c641f947b7e627aefe9b20d4cce8897 840w, https://mintcdn.com/msportal/0zQdy91LsYHrBbny/images/product/companies-bulk-custom-field-dialog-branch-preview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=0zQdy91LsYHrBbny\u0026q=85\u0026s=84f7a6e310f8893fb7fe1c0b9082153c 1100w, https://mintcdn.com/msportal/0zQdy91LsYHrBbny/images/product/companies-bulk-custom-field-dialog-branch-preview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=0zQdy91LsYHrBbny\u0026q=85\u0026s=873d26c6847123b20f82b6027e5fe2ad 1650w, https://mintcdn.com/msportal/0zQdy91LsYHrBbny/images/product/companies-bulk-custom-field-dialog-branch-preview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=0zQdy91LsYHrBbny\u0026q=85\u0026s=a91ada9fbe2311765d06e124942992c3 2500w`})}),`\n`,_jsx(Heading,{level:`3`,id:`replace-clear-and-required-fields`,children:`Replace, clear and required fields`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Apply replaces the existing value`}),` on every selected company. It does not add to it. For a `,_jsx(_components.strong,{children:`Multi-Select`}),` field, the companies end up with exactly the options you chose.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Clear Value removes the field’s value`}),` from every selected company. You do not need to enter a value first.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Required fields cannot be cleared.`}),` The dialog disables `,_jsx(_components.strong,{children:`Clear Value`}),` and says the field cannot be cleared. Apply still works.`]}),`\n`,_jsx(_components.li,{children:`Apply updates all selected companies together. If it fails, no company changes.`}),`\n`,_jsx(_components.li,{children:`Clear Value works through the companies in batches. If it stops partway, the message says how many companies were cleared. Run Clear Value again to clear the rest.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`To check the result, open the column menu and turn on the field’s column. Custom field columns are hidden by default.`}),`\n`,_jsx(Heading,{level:`2`,id:`company-users-access-roles-and-team-roles`,children:`Company users, access roles and team roles`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`You want to`}),_jsx(_components.th,{children:`Open`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Manage client users`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Settings > Users \u0026 Roles > Company Users`}),`, or a company’s `,_jsx(_components.strong,{children:`Users`}),` tab`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Define client access`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Settings > Users \u0026 Roles > Roles > Company Roles`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Define internal staff access`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Settings > Users \u0026 Roles > Roles > Tenant Roles`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Define account-team responsibilities`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Settings > Users \u0026 Roles > Team Roles`})})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Company Roles`}),` control client access. `,_jsx(_components.strong,{children:`Team Roles`}),` describe MSP responsibilities, such as account manager. Assigning a staff member to a team role can limit their company selector to the companies they are assigned. A team role does not give a client user any permission.`]}),`\n`,_jsxs(_components.p,{children:[`Every parent company has a `,_jsx(_components.strong,{children:`Parent Admin`}),` team role. On the parent company’s `,_jsx(_components.strong,{children:`Team`}),` tab, assign a client user to it to give them every child company and a company selector. See `,_jsx(_components.a,{href:`/user-guides/settings/parent-company-access`,children:`Give a parent-company user access to child companies`}),`. On a parent company’s row menu, `,_jsx(_components.strong,{children:`Sync Roles to Children`}),` copies the roles of the parent company’s admin users to its child companies.`]}),`\n`,_jsxs(_components.p,{children:[`On a company’s `,_jsx(_components.strong,{children:`Users`}),` tab, the `,_jsx(_components.strong,{children:`Email`}),` column lists any other addresses linked to a person, such as the address on their PSA contact or Microsoft 365 account, under their main email. The person’s details show every address under `,_jsx(_components.strong,{children:`Email addresses`}),`. With Microsoft or Google sign-in, they can sign in with any of them.`]}),`\n`,_jsxs(_components.p,{children:[`For permission changes, see `,_jsx(_components.a,{href:`/user-guides/settings/change-company-user-permissions`,children:`Change a Company user’s permissions`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`auto-mapping-psa-contact-types-to-roles`,children:`Auto-Mapping PSA Contact Types to Roles`}),`\n`,_jsx(_components.p,{children:`If you use ConnectWise, Autotask or Halo, you can map PSA roles and contact types to your team roles. MSPortal then assigns people to a company’s roles from your PSA data on each sync.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Team Roles`,children:_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Settings > Users \u0026 Roles > Team Roles`}),`.`]})}),_jsx(Step,{title:`Edit a role`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Add Role`}),` for a new role, or the edit icon on an existing one.`]})}),_jsx(Step,{title:`Pick the PSA roles`,children:_jsxs(_components.p,{children:[`In the PSA column (`,_jsx(_components.strong,{children:`CW Team Roles`}),`, `,_jsx(_components.strong,{children:`Autotask Roles`}),` or `,_jsx(_components.strong,{children:`Halo Roles`}),`), pick the PSA roles that should map to this team role.`]})}),_jsx(Step,{title:`Save the role`,children:_jsx(_components.p,{children:`Click the check mark or press Enter. The next sync applies the mapping.`})})]}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.a,{href:`/user-guides/settings/global-team-roles`,children:`Global team role`}),` is held by one named person and has no PSA mapping. Roles you do not map stay manually managed. A manual change to a mapped assignment can be overwritten by the next sync. See `,_jsx(_components.a,{href:`/user-guides/getting-started/onboarding/company-roles`,children:`Account teams and Team Roles`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`delete-a-company`,children:`Delete a company`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the row menu`,children:_jsxs(_components.p,{children:[`In the company list, open the row’s `,_jsx(_components.strong,{children:`…`}),` menu and click `,_jsx(_components.strong,{children:`Delete Company`}),`. This needs manage access.`]})}),_jsx(Step,{title:`Read the warning`,children:_jsx(_components.p,{children:`The dialog lists what is permanently deleted: company data and settings, compliance history, user associations, training records, tickets and locations.`})}),_jsx(Step,{title:`Confirm`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Delete Company`}),`. Deleting cannot be undone.`]})})]}),`\n`,_jsxs(_components.p,{children:[`Do not delete a company to hide it or to fix an import. Change its status to inactive instead. A deleted company is blocked from being imported again. To allow it back, click `,_jsx(_components.strong,{children:`Blocked Companies`}),` in the page header, select it and click `,_jsx(_components.strong,{children:`Unblock`}),`. Unblocking lets it be imported again. It does not restore deleted data.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Hardware defaults`}),` in the page header sets the global hardware standards that every company inherits. It applies to the whole tenant, not to one company.`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Problem`}),_jsx(_components.th,{children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`New from import`}),` is missing`]}),_jsxs(_components.td,{children:[`Connect a supported PSA. Your role also needs `,_jsx(_components.strong,{children:`Integration Company Mapping`}),` write access`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`A PSA company isn’t in the `,_jsx(_components.strong,{children:`New from import`}),` list`]}),_jsxs(_components.td,{children:[`It’s already linked to a company in MSPortal. Search the company list for it, or check the link in `,_jsx(_components.a,{href:`/user-guides/settings/integration-company-mapping`,children:`Integration Company Mapping`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A company is missing`}),_jsxs(_components.td,{children:[`Clear the list filters. Check `,_jsx(_components.strong,{children:`Status`}),`, your access and your import mapping before you add a duplicate`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`The `,_jsx(_components.strong,{children:`Actions`}),` menu is missing`]}),_jsx(_components.td,{children:`Select at least one company. You need write access`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Delete Selected`}),`, `,_jsx(_components.strong,{children:`Blocked Companies`}),`, `,_jsx(_components.strong,{children:`AI Home`}),` or `,_jsx(_components.strong,{children:`Turn off AI`}),` is missing`]}),_jsx(_components.td,{children:`These need manage access`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The assistant says AI is turned off for a company`}),_jsxs(_components.td,{children:[`AI is off for that company. Turn it back on in its `,_jsx(_components.strong,{children:`AI`}),` card, or pick other companies`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Enable Premium Training`}),` is missing`]}),_jsx(_components.td,{children:`You need the Training manage permission`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A client cannot sign in`}),_jsx(_components.td,{children:`Check the person’s Company user record and Company role. A company contact email does not create a login`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A parent-company user sees only their own company`}),_jsxs(_components.td,{children:[`Assign them the Parent Admin team role. See `,_jsx(_components.a,{href:`/user-guides/settings/parent-company-access`,children:`Give a parent-company user access to child companies`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A bulk action hit more companies than expected`}),_jsxs(_components.td,{children:[`Check whether the selection covered one page or all matching companies. The `,_jsx(_components.strong,{children:`Actions`}),` count shows which`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Edit Custom Field`}),` says no company custom fields are defined`]}),_jsxs(_components.td,{children:[`Create a field on the `,_jsx(_components.strong,{children:`Companies`}),` tab in `,_jsx(_components.strong,{children:`Settings > Customization > Fields`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`frequently-asked-questions`,children:`Frequently asked questions`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Where are Company Users now?`,id:`where-are-company-users-now`,children:_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Settings > Users \u0026 Roles > Company Users`}),`, or the `,_jsx(_components.strong,{children:`Users`}),` tab inside a company.`]})}),_jsx(Accordion,{title:`Are Team Roles job labels for client users?`,id:`are-team-roles-job-labels-for-client-users`,children:_jsx(_components.p,{children:`No. They define MSP account-team responsibilities. Assignments can change a staff member’s company scope and the client team menu.`})}),_jsx(Accordion,{title:`Does a company contact email create a portal login?`,id:`does-a-company-contact-email-create-a-portal-login`,children:_jsx(_components.p,{children:`No. Add the person as a Company user and assign a Company role.`})}),_jsx(Accordion,{title:`Does the Compliance Schedule field create automated compliance runs?`,id:`does-the-compliance-schedule-field-create-automated-compliance-runs`,children:_jsxs(_components.p,{children:[`No. Automated runs use `,_jsx(_components.strong,{children:`Settings > Compliance`}),` with a run template and explicit targets.`]})}),_jsx(Accordion,{title:`Can a bulk selection include companies that are off screen?`,id:`can-a-bulk-selection-include-companies-that-are-off-screen`,children:_jsx(_components.p,{children:`Yes. Choosing all matching companies includes every company that fits your filters, not only the visible page.`})}),_jsx(Accordion,{title:`Does cancelling Manage Types undo a type I just created?`,id:`does-cancelling-manage-types-undo-a-type-i-just-created`,children:_jsxs(_components.p,{children:[`No. A new type is saved when you create it. `,_jsx(_components.strong,{children:`Apply`}),` separately saves which companies have it.`]})}),_jsx(Accordion,{title:`Does Replace remove PSA-synced types?`,id:`does-replace-remove-psa-synced-types`,children:_jsxs(_components.p,{children:[`No. `,_jsx(_components.strong,{children:`Replace all types`}),` changes manual types only.`]})}),_jsx(Accordion,{title:`Does saving an Overview field save the other tabs?`,id:`does-saving-an-overview-field-save-the-other-tabs`,children:_jsx(_components.p,{children:`No. Each field and each tab saves on its own.`})}),_jsx(Accordion,{title:`Does turning off AI for a company stop AI for my whole organization?`,id:`does-turning-off-ai-for-a-company-stop-ai-for-my-whole-organization`,children:_jsxs(_components.p,{children:[`No. Only that company’s data is kept away from AI. To turn AI off everywhere, use `,_jsx(_components.strong,{children:`Enable all AI-powered features`}),` in `,_jsx(_components.a,{href:`/user-guides/settings/tenant#configure-ai-features`,children:`Tenant Settings`}),`.`]})}),_jsx(Accordion,{title:`Will unblocking a company restore its deleted history?`,id:`will-unblocking-a-company-restore-its-deleted-history`,children:_jsx(_components.p,{children:`No. It only lets the company be imported again.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`related-guides`,children:`Related guides`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/user-guides/settings/users-roles`,children:`Users \u0026 Roles`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/user-guides/company-overview/index`,children:`Company Overview`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/user-guides/integrations/import-companies`,children:`Import Companies`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/user-guides/settings/change-company-user-permissions`,children:`Change a Company user’s permissions`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/user-guides/getting-started/onboarding/company-roles`,children:`Account teams and Team Roles`})}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`traffic-light-staff-guidance`,children:`Traffic Light staff guidance`}),`\n`,_jsxs(_components.p,{children:[`For participating tenants with Traffic Light enabled, the company header shows Amber, Red or Purple badges. Click the badges to show the reason, technician guidance, owner and review date. `,_jsx(_components.strong,{children:`View in Customer Success`}),` opens the detail page when your role can read Client Health. Company portal users do not see this staff guidance.`]}),`\n`,_jsx(Note,{children:`Traffic Light is available only to tenants included in the pilot.`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/msportal/NZ578FFmfU4QohQn/images/product/traffic-light-company-desktop-preview.png?fit=max\u0026auto=format\u0026n=NZ578FFmfU4QohQn\u0026q=85\u0026s=490596e2c31b2f75496cf982cfde94f3`,alt:`Company record with the Red and Purple guidance popover expanded in the header`,width:`1280`,height:`853`,\"data-og-width\":`1280`,\"data-og-height\":`853`,\"data-path\":`images/product/traffic-light-company-desktop-preview.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/msportal/NZ578FFmfU4QohQn/images/product/traffic-light-company-desktop-preview.png?w=280\u0026fit=max\u0026auto=format\u0026n=NZ578FFmfU4QohQn\u0026q=85\u0026s=a32d0ab893e6f4e3a1a5a11030c86df7 280w, https://mintcdn.com/msportal/NZ578FFmfU4QohQn/images/product/traffic-light-company-desktop-preview.png?w=560\u0026fit=max\u0026auto=format\u0026n=NZ578FFmfU4QohQn\u0026q=85\u0026s=2a26a21e35c2f4fb3027a6d48ca5a88c 560w, https://mintcdn.com/msportal/NZ578FFmfU4QohQn/images/product/traffic-light-company-desktop-preview.png?w=840\u0026fit=max\u0026auto=format\u0026n=NZ578FFmfU4QohQn\u0026q=85\u0026s=c057acb9d1cb17c4fa54978313cd0a96 840w, https://mintcdn.com/msportal/NZ578FFmfU4QohQn/images/product/traffic-light-company-desktop-preview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NZ578FFmfU4QohQn\u0026q=85\u0026s=50e3cfbe485ecdb89e6dc86ddcf08fd3 1100w, https://mintcdn.com/msportal/NZ578FFmfU4QohQn/images/product/traffic-light-company-desktop-preview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NZ578FFmfU4QohQn\u0026q=85\u0026s=bc757ac10ff9ad39a8afd95bd24c5ef1 1650w, https://mintcdn.com/msportal/NZ578FFmfU4QohQn/images/product/traffic-light-company-desktop-preview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NZ578FFmfU4QohQn\u0026q=85\u0026s=4bfff62cebb2f9ad28b9ece929f55de8 2500w`})}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/msportal/NZ578FFmfU4QohQn/images/product/traffic-light-company-mobile-preview.png?fit=max\u0026auto=format\u0026n=NZ578FFmfU4QohQn\u0026q=85\u0026s=dd285609620c5b6011fcbb4eb8675dfb`,alt:`Expanded company Traffic Light guidance on a phone`,width:`390`,height:`844`,\"data-og-width\":`390`,\"data-og-height\":`844`,\"data-path\":`images/product/traffic-light-company-mobile-preview.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/msportal/NZ578FFmfU4QohQn/images/product/traffic-light-company-mobile-preview.png?w=280\u0026fit=max\u0026auto=format\u0026n=NZ578FFmfU4QohQn\u0026q=85\u0026s=348c7148b10a70925ac79244d7966b1e 280w, https://mintcdn.com/msportal/NZ578FFmfU4QohQn/images/product/traffic-light-company-mobile-preview.png?w=560\u0026fit=max\u0026auto=format\u0026n=NZ578FFmfU4QohQn\u0026q=85\u0026s=e309f9f505d7e8f29da733ea4394e868 560w, https://mintcdn.com/msportal/NZ578FFmfU4QohQn/images/product/traffic-light-company-mobile-preview.png?w=840\u0026fit=max\u0026auto=format\u0026n=NZ578FFmfU4QohQn\u0026q=85\u0026s=7896742579fb3f98fd3dce51cb50445a 840w, https://mintcdn.com/msportal/NZ578FFmfU4QohQn/images/product/traffic-light-company-mobile-preview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NZ578FFmfU4QohQn\u0026q=85\u0026s=22a2a60e890e165f931e7cf7389f48e0 1100w, https://mintcdn.com/msportal/NZ578FFmfU4QohQn/images/product/traffic-light-company-mobile-preview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NZ578FFmfU4QohQn\u0026q=85\u0026s=fbeaa00bbb78b2e7702cdb2b7579de55 1650w, https://mintcdn.com/msportal/NZ578FFmfU4QohQn/images/product/traffic-light-company-mobile-preview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NZ578FFmfU4QohQn\u0026q=85\u0026s=081a72207a93bef0661ff89717617098 2500w`})}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/user-guides/msp-tools/traffic-light-review`,children:`Traffic Light Review`}),` to change statuses or log reviews.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Companies Settings","description":"Create and maintain client companies, run bulk actions on many companies, and find user and team administration.","icon":"building","href":"/user-guides/settings/companies"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Find a company","slug":"find-a-company","depth":2,"children":[]},{"title":"Create a company","slug":"create-a-company","depth":2,"children":[]},{"title":"Create a company from your PSA","slug":"create-a-company-from-your-psa","depth":2,"children":[]},{"title":"Edit a company","slug":"edit-a-company","depth":2,"children":[{"title":"Add a location","slug":"add-a-location","depth":3,"children":[]}]},{"title":"Import companies","slug":"import-companies","depth":2,"children":[]},{"title":"Run a bulk action","slug":"run-a-bulk-action","depth":2,"children":[]},{"title":"Turn off AI for a company","slug":"turn-off-ai-for-a-company","depth":2,"children":[]},{"title":"Manage company types","slug":"manage-company-types","depth":2,"children":[]},{"title":"Set a custom field on many companies","slug":"set-a-custom-field-on-many-companies","depth":2,"children":[{"title":"Before you start","slug":"before-you-start-2","depth":3,"children":[]},{"title":"Set the value","slug":"set-the-value","depth":3,"children":[]},{"title":"Replace, clear and required fields","slug":"replace-clear-and-required-fields","depth":3,"children":[]}]},{"title":"Company users, access roles and team roles","slug":"company-users-access-roles-and-team-roles","depth":2,"children":[{"title":"Auto-Mapping PSA Contact Types to Roles","slug":"auto-mapping-psa-contact-types-to-roles","depth":3,"children":[]}]},{"title":"Delete a company","slug":"delete-a-company","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Frequently asked questions","slug":"frequently-asked-questions","depth":2,"children":[]},{"title":"Related guides","slug":"related-guides","depth":2,"children":[]},{"title":"Traffic Light staff guidance","slug":"traffic-light-staff-guidance","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/msportal/d65dc731b8cde0aa/roadmap-embed.js"],"subdomain":"msportal","siteName":"MSPortal.ai Documentation","title":"Companies Settings - MSPortal.ai Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T21:49:53.865Z","originalFileLocation":"user-guides/settings/companies.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create and maintain client companies, run bulk actions on many companies, and find user and team administration.\">\u003cmeta data-mint-head name=\"application-name\" content=\"MSPortal.ai Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Companies Settings - MSPortal.ai Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create and maintain client companies, run bulk actions on many companies, and find user and team administration.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MSPortal.ai Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.msportal.ai/user-guides/settings/companies\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://msportal.mintlify.site/_mintlify/api/og/v2?division=Settings\u0026amp;title=Companies+Settings\u0026amp;description=Create+and+maintain+client+companies%2C+run+bulk+actions+on+many+companies%2C+and+find+user+and+team+administration.\u0026amp;theme=88706d4dcbb07b7aeafbf701\u0026amp;signature=262b6a53dde5df5f9c1c4b23d7c90f54de55b8c44a0598e1f9aea0cc87ecd309\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Companies Settings - MSPortal.ai Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create and maintain client companies, run bulk actions on many companies, and find user and team administration.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://msportal.mintlify.site/_mintlify/api/og/v2?division=Settings\u0026amp;title=Companies+Settings\u0026amp;description=Create+and+maintain+client+companies%2C+run+bulk+actions+on+many+companies%2C+and+find+user+and+team+administration.\u0026amp;theme=88706d4dcbb07b7aeafbf701\u0026amp;signature=262b6a53dde5df5f9c1c4b23d7c90f54de55b8c44a0598e1f9aea0cc87ecd309\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MSPortal.ai Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0C8376\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.msportal.ai/user-guides/settings/companies\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/user-guides/settings/companies.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.msportal.ai/#organization\",\"name\":\"MSPortal.ai Documentation\",\"url\":\"https://docs.msportal.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/msportal/KnbwIXtZSTlVJTt6/logo/light.svg?fit=max\u0026auto=format\u0026n=KnbwIXtZSTlVJTt6\u0026q=85\u0026s=eb69f6d6bf16b2c401770aef19ade1d2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.msportal.ai#website\",\"name\":\"MSPortal.ai Documentation\",\"url\":\"https://docs.msportal.ai\",\"publisher\":{\"@id\":\"https://docs.msportal.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.msportal.ai/user-guides/settings/companies#webpage\",\"url\":\"https://docs.msportal.ai/user-guides/settings/companies\",\"name\":\"Companies Settings\",\"description\":\"Create and maintain client companies, run bulk actions on many companies, and find user and team administration.\",\"dateModified\":\"2026-11-12T21:49:53.865Z\",\"isPartOf\":{\"@id\":\"https://docs.msportal.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.msportal.ai/user-guides/settings/companies#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.msportal.ai/user-guides/settings/companies#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Settings\",\"item\":\"https://docs.msportal.ai/user-guides/settings\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Companies Settings\",\"item\":\"https://docs.msportal.ai/user-guides/settings/companies\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.msportal.ai/user-guides/settings/companies#article\",\"headline\":\"Companies Settings\",\"name\":\"Companies Settings\",\"description\":\"Create and maintain client companies, run bulk actions on many companies, and find user and team administration.\",\"url\":\"https://docs.msportal.ai/user-guides/settings/companies\",\"mainEntityOfPage\":{\"@id\":\"https://docs.msportal.ai/user-guides/settings/companies#webpage\"},\"dateModified\":\"2026-11-12T21:49:53.865Z\",\"publisher\":{\"@id\":\"https://docs.msportal.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.msportal.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"MSPortal.ai Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"MSPortal.ai Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/user-guides/settings/companies.md","siteName":"MSPortal.ai Documentation","nav":{"global":null,"tabs":[{"tab":"Company Guides","pages":[{"title":"Company Guides","href":"/user-guides/account/manage-your-profile"}]},{"tab":"MSP Guides","anchors":[{"anchor":"Getting started","icon":"rocket","pages":[{"title":"Getting started","href":"/user-guides/getting-started"}]},{"anchor":"Planning","icon":"compass","pages":[{"title":"Planning","href":"/user-guides/company-overview"}]},{"anchor":"Operations","icon":"briefcase","pages":[{"title":"Operations","href":"/user-guides/client-onboarding"}]},{"anchor":"Protection","icon":"shield-halved","pages":[{"title":"Protection","href":"/user-guides/cloud"}]},{"anchor":"MSP Tools","icon":"toolbox","pages":[{"title":"MSP Tools","href":"/user-guides/msp-tools"}]},{"anchor":"Administration","icon":"gear","groups":[{"group":"Settings","pages":[{"title":"Settings overview","icon":"gear","href":"/user-guides/settings"},{"title":"Users \u0026 Roles","icon":"users","href":"/user-guides/settings/users-roles"},{"title":"Global Team Roles","icon":"users","href":"/user-guides/settings/global-team-roles"},{"title":"Change a Company user’s permissions","icon":"user-shield","href":"/user-guides/settings/change-company-user-permissions"},{"title":"Give a parent-company user access to child companies","sidebarTitle":"Parent-company access","icon":"sitemap","href":"/user-guides/settings/parent-company-access"},{"title":"Custom Fields","description":"Define portal fields, save choices separately, and control their scope and Company visibility","icon":"table-list","href":"/user-guides/settings/custom-fields"},{"title":"Companies Settings","icon":"building","href":"/user-guides/settings/companies"},{"title":"Project Settings","description":"Configure client access, health statuses, display fields, Kanban, status mappings, and PSA custom fields","icon":"gear","href":"/user-guides/settings/projects"},{"title":"Planner settings","icon":"table-cells-large","href":"/user-guides/settings/planner-views"},{"title":"Training settings","icon":"graduation-cap","href":"/user-guides/settings/training"},{"title":"Ticket settings","icon":"ticket","href":"/user-guides/settings/tickets"},{"title":"Co-managed support","icon":"handshake","href":"/user-guides/settings/comanaged-support"},{"title":"Compliance Settings","icon":"shield-check","href":"/user-guides/settings/compliance"},{"title":"Schedule compliance assessments","icon":"calendar","href":"/user-guides/settings/compliance-schedules"},{"title":"Configure compliance scoring","icon":"sliders","href":"/user-guides/settings/compliance-scoring"},{"title":"Configure risk tracking and categories","icon":"shield-alert","href":"/user-guides/settings/compliance-risk"},{"title":"Playbook settings","icon":"book","href":"/user-guides/settings/playbooks"},{"title":"External Resources Settings","icon":"link","href":"/user-guides/settings/external"},{"title":"Onboarding Settings","icon":"clipboard-check","href":"/user-guides/settings/onboarding"},{"title":"Note templates","icon":"file-lines","href":"/user-guides/settings/templates"},{"title":"Email settings","icon":"envelope","href":"/user-guides/settings/email"},{"title":"Client Health scoring settings","icon":"heart-pulse","href":"/user-guides/settings/scoring"},{"title":"Traffic Light settings","icon":"traffic-light","href":"/user-guides/settings/traffic-light-settings"},{"title":"Manage the Standards catalog","icon":"wrench","href":"/user-guides/settings/standards"},{"title":"Configure Standards tiers and deployment options","icon":"layer-group","href":"/user-guides/settings/standards-tiers"},{"title":"Choose which Standards apply","icon":"filter","href":"/user-guides/settings/standards-applicability"},{"title":"Use PSA billing to answer Standards","icon":"tags","href":"/user-guides/settings/standards-sku-automation"},{"title":"Sync Standards to companies","icon":"arrows-rotate","href":"/user-guides/settings/sync-standards"},{"title":"Retire Standards definitions","icon":"trash-can","href":"/user-guides/settings/retire-standards"},{"title":"Financial Reporting Settings","icon":"dollar-sign","href":"/user-guides/settings/financial-reporting"},{"title":"Integrations Settings","icon":"plug","href":"/user-guides/settings/integrations"},{"title":"Integration Company Mapping","icon":"diagram-project","href":"/user-guides/settings/integration-company-mapping"},{"title":"Liongard Documentation Visibility","icon":"radar","href":"/user-guides/settings/liongard-visibility"},{"group":"Automation","expanded":false,"pages":[{"title":"Automation Rules","icon":"robot","href":"/user-guides/settings/automation/index"},{"title":"Rule Wizard Walkthrough","icon":"list-check","href":"/user-guides/settings/automation/wizard"},{"title":"Bundling Automation Matches","icon":"layer-group","href":"/user-guides/settings/automation/bundling"},{"title":"Example Automation Rules","icon":"book-open","href":"/user-guides/settings/automation/examples"}]},{"title":"Import and export data","icon":"file-import","href":"/user-guides/settings/import-export"},{"title":"Tenant Settings","icon":"building-columns","href":"/user-guides/settings/tenant"},{"title":"Billing settings","icon":"credit-card","href":"/user-guides/settings/billing"}]},{"group":"Playbooks","pages":[{"title":"Use playbooks to prepare compliance reviews","icon":"book","href":"/user-guides/playbooks/index"}]}]},{"anchor":"Integrations","icon":"plug","pages":[{"title":"Integrations","href":"/user-guides/integrations"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/budgets/list-budgets"}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes"}]}]},"basePath":"","title":"Companies Settings - MSPortal.ai Documentation","buildId":"dpl_5joLUXmnJgwqjrHAS4dxZrQTdxgh","deploymentId":"dpl_5joLUXmnJgwqjrHAS4dxZrQTdxgh","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-B_503rGq.js","DynamicMarkdown-BfddVCX7.js","zoom-image-lightbox-B3yYlvdS.js","lightbox-handle-r17bVUz3.js"]}