Skip to Content

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

Summary

  • Microsoft Teams channels created through the Microsoft Graph v1.0 Create channel API will default to the Threads layout when the request does not include `layoutType`.
  • Existing channels are not affected; this change applies only to newly created channels.
  • Applications, scripts, and automated provisioning workflows that create Teams channels may need updates if they currently rely on the Posts layout by default.
  • To preserve Posts for new channels, channel-creation requests must explicitly set `”layoutType”: “post”`.
  • Third-party provisioning tools should be validated to confirm which layout they send to the Graph API.

Primary Service: Teams
Admin Impact: Medium
User Impact: Low
Release Start: 30 Nov 2026
Release End: 30 Nov 2026
Services: Graph, Teams
Category: Plan for change
Tags: Admin Action, User Adoption

History

10/29/2026 Item Added to Message Center

Microsoft Message

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

Create channel – Microsoft Graph v1.0 | Microsoft Learn

Compliance considerations

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