[Introduction]

Starting November 15, 2025, Outlook on the web and the new Outlook for Windows will begin rolling out an update to how inline images are represented in the HTML body of emails. This change is part of Microsoft’s ongoing security improvements and will affect how Outlook add-ins identify and process inline images using the attachment ID. Specifically, the update transitions from using tokenized image URLs to a more secure method using content IDs and request headers.

[When this will happen:]

This change will begin rolling out on November 15, 2025, to Production users. Rollouts to other environments will begin after Production rollouts are 100% complete.

[How this affects your organization:]

What’s changing:

Previously, inline images in the HTML mail body were represented with a URL containing the attachment ID as a query parameter. Developers could parse the HTML and do one of the following.

• Extract the ID from the URL and match it with the attachment ID they already had.
• Use the entire URL in the src attribute to get the Base64 value of the inline image.

Going forward, the URL for inline images will no longer contain the attachment ID. As a result, your current parsing logic won’t be able to correlate the inline image in the mail body with the attachment ID or Base64 value of the image.

What will happen:

• Images will be represented by a content ID (cid) in the src attribute. 
• Add-ins that extract the attachment ID from the image URL will no longer be able to correlate images reliably.
• With this change, add-ins must:
  
  • Parse the HTML message body and retrieve the cid value from the src attribute of the <img> element.
  • Use Office.context.mailbox.item.getAttachmentsAsync to retrieve an AttachmentDetailsCompose object.
  • To restore correlation, match the contentId property from the object to the cid value in the HTML.
  • To retrieve base64 value of the image attachment, use office.context.mailbox.item.getAttachmentContentAsync. 

Example AttachmentDetailsCompose object:

[
{
  "id": "AAkALgAAAAAAHYQDEapmEc2byACqAC/EWg0AW4xUByFbp0CroCNphMYEEAADMWhyywAAARIAEADghOrwhp8zR7umVQRBkN51",
  "name": "image.png",
  "contentType": "image/png",
  "size": 2371,
  "attachmentType": "file",
  "isInline": true,
  "contentId": "7957e11a-ce80-438b-87cd-611b3d6a3ec4"
}
]

[What you can do to prepare:]

• Update your add-in’s parsing logic to retrieve the cid value from the src attribute of inline images.
• Use getAttachmentsAsync to match the content ID with the image.
• Ensure your add-in supports both the previous and updated implementations during the rollout.
• Test your add-in to confirm it correctly identifies and processes inline images using the new method.
• Update internal developer documentation if it references the previous method of parsing inline image URLs.
• Communicate this change to helpdesk or support teams if they assist with Outlook add-in troubleshooting.
• Review the sample code provided in the Microsoft 365 Developer Blog: Changes to inline images in Outlook.
• Leave a comment on this post or in Microsoft 365 Developer Blog: Changes to inline images in Outlook if you have any questions.
• Watch the October 2025 Office Add-ins Community Call (YouTube link)

[Compliance considerations:]

Placing the content ID in the src attribute matches how classic Outlook on Windows represents inline images.

[はじめに]

2025 年 11 月 15 日以降、Outlook on the web と新しい Outlook for Windows では、電子メールの HTML 本文でのインライン画像の表現方法の更新プログラムのロールアウトが開始されます。この変更は、Microsoft の継続的なセキュリティ改善の一部であり、Outlook アドインが添付ファイル ID を使用してインライン画像を識別および処理する方法に影響します。具体的には、更新プログラムは、トークン化された画像 URL の使用から、コンテンツ ID と要求ヘッダーを使用するより安全な方法に移行します。

[これがいつ起こるか:]

この変更は、2025 年 11 月 15 日に本番ユーザー向けに展開されます。他の環境へのロールアウトは、本番環境のロールアウトが 100% 完了した後に開始されます。

[これがあなたの組織に与える影響:]

変更点:

以前は、HTML メール本文のインライン画像は、照会パラメータとして添付ファイル ID を含む URL で表されていました。開発者は HTML を解析して、次のいずれかを実行できます。

• URL から ID を抽出し、すでに持っている添付ファイル ID と照合します。
• src 属性の URL 全体を使用して、インライン画像の Base64 値を取得します。

今後、インライン画像の URL には添付ファイル ID が含まれなくなります。その結果、現在の解析ロジックでは、メール本文のインライン画像を画像の添付ファイル ID または Base64 値と関連付けることができません。

何が起こるか:

• 画像は、src 属性のコンテンツ ID(cid)で表されます。 
• 画像 URL から添付ファイル ID を抽出するアドインは、画像を確実に関連付けることができなくなります。
• この変更により、アドインは次のことを行う必要があります。
  • HTML メッセージ本文を解析し、<img> 要素の src 属性からcid値を取得します。
  • Office.context.mailbox.item.getAttachmentsAsync を使用して、AttachmentDetailsCompose オブジェクトを取得します。
  • 相関関係を復元するには、オブジェクトの contentId プロパティを HTML の cid 値に一致させます。
  • 画像添付ファイルの base64 値を取得するには、 office.context.mailbox.item.getAttachmentContentAsync を使用します。 

AttachmentDetailsCompose オブジェクトの例:

[
{
  "id": "AAkALgAAAAAAHYQDEapmEc2byACqAC/EWg0AW4xUByFbp0CroCNphMYEEAADMWhyywAAARIAEADghOrwhp8zR7umVQRBkN51",
  "name": "image.png",
  "contentType": "image/png",
  "size": 2371,
  "attachmentType": "file",
  "isInline": true,
  "contentId": "7957e11a-ce80-438b-87cd-611b3d6a3ec4"
}
]

[準備するためにできること:]

• アドインの解析ロジックを更新して、インライン画像の src 属性からcid値を取得します。
• getAttachmentsAsyncを使用して、コンテンツ ID と画像を一致させます。
• ロールアウト中に、アドインが以前の実装と更新された実装の両方をサポートしていることを確認します。
• アドインをテストして、新しいメソッドを使用してインライン イメージを正しく識別して処理することを確認します。
• インライン画像 URL を解析する以前の方法を参照している場合は、社内の開発者向けドキュメントを更新します。
• この変更をヘルプデスクまたはサポート チームが Outlook アドインのトラブルシューティングを支援する場合は、その旨を伝えます。
• Microsoft 365 開発者ブログ: Outlook のインライン画像への変更で提供されているサンプル コードを確認します。
• この投稿または Microsoft 365開発者ブログにコメントを残してください:質問がある場合は、Outlook のインライン画像の変更。
• 2025 年 10 月の Office アドイン コミュニティ コール (YouTube リンク) を視聴する

[コンプライアンスに関する考慮事項:]

src 属性にコンテンツ ID を配置すると、従来の Outlook on Windows がインライン イメージを表す方法と一致します。