MC1530957 High

Microsoft Teams: Threads will become the default layout for new channels created with Microsoft Graph

  • Admin

Summary AI-generated

Default channel layout for Teams channels made via Microsoft Graph will change to Threads if layoutType is omitted; update requests for Posts layout as needed.

Suggested actions AI-generated

  • Notify developers and app owners creating Teams channels via Microsoft Graph
  • Update creation requests to specify 'layoutType': 'post' if Posts layout is needed
  • Contact third-party solution providers to confirm layout specification
  • Review and test workflows for Threads compatibility

Written by Azure OpenAI (gpt-4.1) from the text of the post below. It can be incomplete or wrong; the original post is authoritative.

Original post from Microsoft

[What and why]

We're updating the default message layout for new Microsoft Teams channels created through the Microsoft Graph v1.0 Create channel API (POST /v1.0/teams/{team-id}/channels). When a channel creation request doesn't specify the layoutType property, the new channel will use the Threads layout instead of the Posts layout.

This change applies only to newly created channels. Existing channels won't change.

[Rollout schedule]

  • General Availability (Worldwide, GCC, GCC High, DoD): Beginning in late November 2026 and expected to complete by late November 2026

[Impact on your organization]

Who is affected

  • Organizations with applications, scripts, or automated provisioning workflows that create Microsoft Teams channels through Microsoft Graph without specifying the layoutType property

Platforms and services

  • Microsoft Teams and Microsoft Graph v1.0 Create channel API

What will happen

  • If layoutType is omitted, new channels will use the Threads layout instead of the Posts layout.
  • If "layoutType": "post" is specified, new channels will use the Posts layout.
  • If "layoutType": "chat" is specified, new channels will use the Threads layout.
  • The API value for the Threads layout is "chat", not "threads".
  • Existing channels won't change.
  • Channel creation requests that explicitly specify a supported layout aren't affected.

[Action required and recommendations]

  • Notify developers and owners of applications or automation that create Teams channels through Microsoft Graph.
  • If your organization requires new channels to continue using the Posts layout, update channel creation requests to explicitly include "layoutType": "post" before rollout begins.
  • For third-party solutions, contact the provider to confirm how the solution specifies the channel layout.
  • If Threads is your desired layout, no request changes are required to adopt the new default.
  • Review and test dependent workflows for compatibility with Threads.

Learn more

[Compliance considerations]

No compliance considerations identified. Review as appropriate for your organization.

Additional details from Microsoft

Summary
Starting late November 2026, new Microsoft Teams channels created via Microsoft Graph without a specified layoutType will default to the Threads layout ("chat"). Existing channels remain unchanged. Organizations should update automation to specify "post" if Posts layout is required or test workflows for compatibility with Threads.