Fix Teams Template Creates the Wrong Channels after a Tenant Rename
🔍 WiseChecker

Fix Teams Template Creates the Wrong Channels after a Tenant Rename

After a tenant rename, you may find that a Teams team template creates channels with old names or in the wrong order. This happens because the template stores the original tenant-specific channel URLs and display names. This article explains why the rename breaks the template and how to rebuild the template so it creates the correct channels. You will also learn how to verify the fix and avoid a similar problem in the future.

Key Takeaways: Fix Teams Template Channel Names After a Tenant Rename

  • Teams admin center > Team templates > Edit: Edit the template to see the stale channel names and URLs.
  • Teams admin center > Team templates > Duplicate: Duplicate the broken template, rename the copy, and update the channels.
  • Teams admin center > Team templates > New template: Create a fresh template from scratch to avoid inherited stale data.

ADVERTISEMENT

Why a Tenant Rename Breaks Teams Templates

A tenant rename changes the primary domain and the tenant ID that appears in many Microsoft 365 URLs. When you create a team from a template, Teams copies the channel structure defined in the template. If the template was created before the rename, it still contains the old domain in the channel URLs and the old display names for the channels.

Teams does not automatically update existing templates after a tenant rename. The template stores a snapshot of the channel configuration, not a live reference. So when you apply the template, Teams tries to create channels using the old URLs. The result is that channels appear with the old tenant name in the URL, or the channel creation fails entirely.

What Exactly Goes Wrong

The most common symptom is that the channel names in the new team match the old tenant name, not the new one. For example, if your tenant was renamed from oldcompany.onmicrosoft.com to newcompany.onmicrosoft.com, the channels may still show oldcompany in their URLs. In some cases, the channel order changes because the template references a missing parent channel.

Another problem is that the template may point to a SharePoint site URL that no longer exists. This causes the channel creation to fail silently, leaving you with a team that has only the General channel. The team itself is created, but the extra channels are missing.

Steps to Rebuild the Template with Correct Channels

The fix is to create a new template from a team that already has the correct channels, or to edit the existing template and manually correct the channel names. The following steps show both methods. Choose the one that fits your situation.

Method 1: Edit the Existing Template

  1. Open the Teams admin center
    Go to Teams admin center > Team templates. Find the template that creates the wrong channels.
  2. Select the template and click Edit
    Click the template name to open its details. Then click Edit in the top toolbar.
  3. Review the channel list
    In the Channels section, look for any channel name that contains the old tenant name. Also check the URL field under each channel if it is visible.
  4. Update the channel names
    For each channel with a stale name, type the correct name. For example, change General – oldcompany to General. Do not change the channel type or the privacy setting unless needed.
  5. Update the channel URLs
    If the template shows a URL field, replace the old tenant domain with the new one. For example, change https://oldcompany.sharepoint.com to https://newcompany.sharepoint.com.
  6. Save the template
    Click Save to apply the changes. Then test the template by creating a new team from it.

Method 2: Create a New Template from a Team with Correct Channels

  1. Create a team with the correct channels manually
    If you do not have a team with the right channel structure, create one first. Use the Create team wizard in Teams and add the channels you want.
  2. Open the Teams admin center
    Go to Teams admin center > Team templates.
  3. Click New template
    Click New template and choose Use an existing team as a template.
  4. Select the team with correct channels
    In the dialog, select the team you just created. This team must have the correct channel names and order.
  5. Name the template and save
    Give the template a descriptive name, such as Project Team – Corrected. Then click Create.
  6. Test the new template
    Create a new team from this template and verify that all channels appear with the new tenant name.

ADVERTISEMENT

If the Template Still Creates the Wrong Channels

Teams Shows a Blank Window After Applying the Template

If the team is created but the channel list is empty, the template may be referencing a deleted SharePoint site. Delete the team, create a new team with the correct channels, and then create a fresh template from that team.

Channel Order Is Wrong Even After Editing

Editing the template may not fix the channel order if the original template had a broken parent-child relationship. In that case, duplicate the template, delete all channels, and add them again in the correct order. Use the Duplicate action in the admin center to copy the template, then edit the copy.

Template Does Not Appear in the Team Creation Wizard

If the corrected template does not show up when you create a team, check that the template is still assigned to a policy. Go to Teams admin center > Teams policies and verify that the template is included in the policy that applies to your users.

Old Template vs New Template: What Changed

Item Old Template (Before Rename) New Template (After Rename)
Channel names Contain the old tenant name Use the new tenant name
Channel URLs Point to oldcompany.sharepoint.com Point to newcompany.sharepoint.com
Channel order May be incorrect due to missing references Matches the source team exactly
Creation reliability May fail or create partial teams Creates all channels without errors

After you rebuild the template, test it by creating a team and checking the channel list. If you have many templates, review each one after a tenant rename. Use the Duplicate action to preserve the original template while you create a corrected copy.

ADVERTISEMENT