How to Troubleshoot Hub Association Is Greyed Out in Admin Center
🔍 WiseChecker

How to Troubleshoot Hub Association Is Greyed Out in Admin Center

When you try to associate a SharePoint site with a hub site in the SharePoint admin center, the hub association option may appear greyed out. This prevents you from linking the site to the hub, which limits navigation and branding consistency across your site collection. The root cause is usually a missing or misconfigured hub site registration, a site being the wrong type, or insufficient permissions. This article explains why the option is disabled and provides step-by-step fixes to enable hub association for your sites.

Key Takeaways: Fixing Hub Association Greyed Out

  • SharePoint admin center > Active sites > select a site > Hub: The main location where you set or change hub association. If greyed out, the target hub site may not be registered.
  • Register a site as a hub site using PowerShell: Run Register-SPOHubSite to make any communication site or team site a hub site, enabling association for other sites.
  • Check site type and permissions: Only communication sites and modern team sites can be associated with a hub. The user must be a SharePoint admin or site collection admin.

ADVERTISEMENT

Why Hub Association Is Greyed Out in the Admin Center

The hub association option is greyed out because the target site you want to use as a hub is not registered as a hub site in SharePoint. Without registration, the admin center has no hub site to offer for association. Additionally, the site you are trying to associate must be a communication site or a modern team site. Classic team sites, publishing sites, and other legacy site templates cannot be associated with a hub. Permissions also play a role: only SharePoint admins, site collection admins, or members of the hub site owners group can change hub association.

Hub Site Registration Requirement

A site must first be registered as a hub site using the SharePoint admin center or PowerShell. Registration tells SharePoint that this site can serve as a central point for navigation and news aggregation. Without registration, the site appears in the hub list but the association option remains disabled.

Site Type Restrictions

SharePoint restricts hub association to specific site templates. Communication sites and modern team sites (group-connected or not) support hub association. Classic team sites, publishing sites, and wiki sites do not. If you are trying to associate a classic site, you must first upgrade it to a modern experience or create a new modern site.

Permission Requirements

To change hub association, you need at least one of these roles: SharePoint admin in the Microsoft 365 admin center, site collection admin on the hub site, or owner of the hub site. If you have read-only access or are a member only, the option will be greyed out.

Steps to Enable Hub Association

Follow these steps to register a hub site and associate a site with it. You will need SharePoint admin permissions or site collection admin permissions.

Method 1: Register a Hub Site in the Admin Center

  1. Open SharePoint admin center
    Go to https://admin.microsoft.com and select SharePoint in the left navigation. Alternatively, go directly to https://admin.microsoft.com/SharePoint.
  2. Navigate to Active sites
    In the left menu, click Active sites. A list of all sites in your tenant appears.
  3. Select the hub site candidate
    Click the name of the site you want to register as a hub site. This should be a communication site or a modern team site.
  4. Open the Hub panel
    In the site details panel, click the Hub tab. If the site is not yet a hub, you will see Register as hub site. Click it.
  5. Configure hub settings
    Enter a Hub site name and optionally a Description. Select the Associated site type if desired. Click Save.
  6. Verify registration
    The site now shows a hub icon in the Active sites list. The hub association option on other sites will no longer be greyed out.

Method 2: Register a Hub Site Using PowerShell

If the admin center does not show the register option, use PowerShell. You need the SharePoint Online Management Shell installed and a SharePoint admin account.

  1. Connect to SharePoint Online
    Open PowerShell as an administrator. Run Connect-SPOService -Url https://yourtenant-admin.sharepoint.com. Enter your admin credentials.
  2. Register the hub site
    Run Register-SPOHubSite -Site https://yourtenant.sharepoint.com/sites/yoursite. Replace the URL with your site URL.
  3. Confirm registration
    Run Get-SPOHubSite to list all registered hub sites. Your site should appear in the list.
  4. Associate a site with the hub
    Now go to the SharePoint admin center, select another site, and open the Hub tab. The hub association dropdown should list your registered hub site.

Method 3: Check and Fix Permissions

  1. Verify your admin role
    In the Microsoft 365 admin center, go to Users > Active users. Select your account and check the Roles tab. You need SharePoint administrator or Global administrator.
  2. Add yourself as site collection admin
    If you are not a SharePoint admin, ask the site owner to add you. In the site, go to Settings > Site permissions > Advanced permissions settings > Site Collection Administrators. Add your account.
  3. Try association again
    After permissions are updated, refresh the admin center and check the Hub tab. The option should be available.

ADVERTISEMENT

If Hub Association Still Has Issues After the Main Fix

Hub Association Option Still Greyed Out After Registration

If you registered the hub site but the association option remains greyed out, the site you are trying to associate might be a classic site. Classic sites do not support hub association. To confirm, go to the site and check the site template under Site settings > Site information. If the template is Team site (classic) or Publishing site, you cannot associate it. Create a new modern communication site or team site and migrate your content.

Hub Association Works but Does Not Show Navigation

After associating a site, the hub navigation may not appear immediately. This is usually a caching issue. Wait up to 24 hours for the navigation to propagate. You can also force a refresh by clearing your browser cache or using an InPrivate/Incognito window.

Cannot Remove Hub Association

If you need to disassociate a site from a hub but the option is greyed out, you might not have permissions on the hub site. Go to the hub site, add yourself as a site collection admin, then try again. Alternatively, use PowerShell: Remove-SPOHubSiteAssociation -Site https://yourtenant.sharepoint.com/sites/yoursite.

Item Admin Center PowerShell
Register a hub site Active sites > select site > Hub > Register as hub site Register-SPOHubSite -Site URL
Associate a site with hub Active sites > select site > Hub > choose hub from dropdown Add-SPOHubSiteAssociation -Site URL -HubSite URL
Remove hub association Active sites > select site > Hub > Remove association Remove-SPOHubSiteAssociation -Site URL
Check hub site registration Active sites > look for hub icon in list Get-SPOHubSite

You can now register a hub site and associate other sites with it using the admin center or PowerShell. If the option remains greyed out, verify the site type and your permissions. For advanced management, use PowerShell cmdlets like Set-SPOHubSite to change hub site settings such as the hub site name or description without using the admin interface.

ADVERTISEMENT