{"id":24816,"date":"2025-10-29T08:33:20","date_gmt":"2025-10-29T15:33:20","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=24816"},"modified":"2025-10-29T08:37:39","modified_gmt":"2025-10-29T15:37:39","slug":"deprecation-of-the-previewimageurl-property-for-insights-items-that-reference-file-attachments","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/deprecation-of-the-previewimageurl-property-for-insights-items-that-reference-file-attachments\/","title":{"rendered":"Deprecation of the previewImageUrl property for Insights items that reference file attachments"},"content":{"rendered":"<p><span style=\"color: black;\">We\u2019re deprecating the <strong>previewImageUrl <\/strong><\/span><span style=\"color: black;\">property in the<\/span>\u00a0<a href=\"https:\/\/learn.microsoft.com\/en-gb\/graph\/api\/resources\/insights-resourcevisualization?view=graph-rest-1.0\">resourceVisualization<\/a> <span style=\"color: black;\">complex type for <a title=\"https:\/\/learn.microsoft.com\/en-gb\/graph\/api\/resources\/officegraphinsights?view=graph-rest-1.0\" href=\"https:\/\/nam06.safelinks.protection.outlook.com\/?url=https%3A%2F%2Flearn.microsoft.com%2Fen-gb%2Fgraph%2Fapi%2Fresources%2Fofficegraphinsights%3Fview%3Dgraph-rest-1.0&amp;data=05%7C02%7Clauragra%40microsoft.com%7C61519c7c51e44cb5a9a508de058d563e%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C638954301862759107%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&amp;sdata=pAYL%2F7uKyo6Nqk6pPmuMJsl%2BaRd9tkRR7z7Tn5TFiqU%3D&amp;reserved=0\">Insights items<\/a>\u00a0where the referenced resource is a file attachment (<\/span><code><span style=\"font-size: 10.0pt; color: black;\">resourceReference.type<\/span><\/code><span style=\"color: black;\">\u00a0= <\/span><code><span style=\"font-size: 10.0pt; color: black;\">fileAttachment<\/span><\/code><span style=\"color: black;\">). This affects responses from the <a title=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/insights-list-shared?view=graph-rest-1.0&amp;tabs=http\" href=\"https:\/\/nam06.safelinks.protection.outlook.com\/?url=https%3A%2F%2Flearn.microsoft.com%2Fen-us%2Fgraph%2Fapi%2Finsights-list-shared%3Fview%3Dgraph-rest-1.0%26tabs%3Dhttp&amp;data=05%7C02%7Clauragra%40microsoft.com%7C61519c7c51e44cb5a9a508de058d563e%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C638954301862771161%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&amp;sdata=dZAHGSgAOdhJcMP5IvykVWli9qSsKDOrAf%2FegtAm43U%3D&amp;reserved=0\">Insights List shared<\/a>\u00a0and <a title=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/insights-list-used?view=graph-rest-1.0&amp;tabs=http\" href=\"https:\/\/nam06.safelinks.protection.outlook.com\/?url=https%3A%2F%2Flearn.microsoft.com%2Fen-us%2Fgraph%2Fapi%2Finsights-list-used%3Fview%3Dgraph-rest-1.0%26tabs%3Dhttp&amp;data=05%7C02%7Clauragra%40microsoft.com%7C61519c7c51e44cb5a9a508de058d563e%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C638954301862783005%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&amp;sdata=hXSUHv0UOB%2FVUV%2FhhLGo2nVu%2FukLHvG68YmvJoxnZA0%3D&amp;reserved=0\">Insights List used<\/a>\u00a0APIs when the underlying resource is an email attachment.<\/span><\/p>\n<h2>What\u2019s changing and why<\/h2>\n<p>The <strong>previewImageUrl<\/strong> property is no longer returned for file attachment items. File attachments don\u2019t have a consistent preview experience across Microsoft 365, so removing this property simplifies the API and aligns it with supported preview scenarios. Items that reference cloud files (like <strong>driveItem<\/strong>) aren&#8217;t impacted.<\/p>\n<h3>Timeline<\/h3>\n<ul>\n<li><strong>Deprecation notice<\/strong>: Effective immediately<\/li>\n<li><strong>Removal date<\/strong>: November 1, 2027<\/li>\n<\/ul>\n<h2><strong>Action required<\/strong><\/h2>\n<ul>\n<li>If your app uses <code>resourceVisualization.previewImageUrl<\/code> for file attachment insights, update your logic to handle the absence of this property.<\/li>\n<li>For previews, prefer modern attachments (cloud files) and use the <a href=\"https:\/\/nam06.safelinks.protection.outlook.com\/?url=https%3A%2F%2Flearn.microsoft.com%2Fen-gb%2Fgraph%2Fapi%2Fdriveitem-preview%3Fview%3Dgraph-rest-1.0&amp;data=05%7C02%7Clauragra%40microsoft.com%7C61519c7c51e44cb5a9a508de058d563e%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C638954301862794175%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&amp;sdata=STGO7A7WOORgNePUSk%2F9bB6bEOHv0NZ%2B%2FiTeUIIdoPo%3D&amp;reserved=0\">driveItem: preview<\/a> action where applicable.<\/li>\n<\/ul>\n<h2><strong>Resources<\/strong><\/h2>\n<ul>\n<li><a href=\"https:\/\/nam06.safelinks.protection.outlook.com\/?url=https%3A%2F%2Flearn.microsoft.com%2Fen-us%2Fgraph%2Fapi%2Finsights-list-shared%3Fview%3Dgraph-rest-1.0%26tabs%3Dhttp&amp;data=05%7C02%7Clauragra%40microsoft.com%7C61519c7c51e44cb5a9a508de058d563e%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C638954301862805165%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&amp;sdata=5AsHGgUUpD57s02fd%2F6WSDmFUbIMISJkNTqiAPaOSYU%3D&amp;reserved=0\">List shared<\/a><\/li>\n<li><a href=\"https:\/\/nam06.safelinks.protection.outlook.com\/?url=https%3A%2F%2Flearn.microsoft.com%2Fen-us%2Fgraph%2Fapi%2Finsights-list-used%3Fview%3Dgraph-rest-1.0%26tabs%3Dhttp&amp;data=05%7C02%7Clauragra%40microsoft.com%7C61519c7c51e44cb5a9a508de058d563e%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C638954301862816829%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&amp;sdata=VDC6Y6FpSJeYtO2y4FRH555kHvW4ADRgi49UNRrYDXg%3D&amp;reserved=0\">List used<\/a><\/li>\n<li><a href=\"https:\/\/nam06.safelinks.protection.outlook.com\/?url=https%3A%2F%2Flearn.microsoft.com%2Fen-gb%2Fgraph%2Fapi%2Fresources%2Fofficegraphinsights%3Fview%3Dgraph-rest-1.0&amp;data=05%7C02%7Clauragra%40microsoft.com%7C61519c7c51e44cb5a9a508de058d563e%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C638954301862827941%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&amp;sdata=ibgonz2583G6l1F7JcTwSFDoU%2F8KZqA20siAMQAAgak%3D&amp;reserved=0\">officeGraphInsights resource type<\/a><\/li>\n<li><a href=\"https:\/\/nam06.safelinks.protection.outlook.com\/?url=https%3A%2F%2Flearn.microsoft.com%2Fen-gb%2Fgraph%2Fapi%2Fresources%2Finsights-shared%3Fview%3Dgraph-rest-1.0&amp;data=05%7C02%7Clauragra%40microsoft.com%7C61519c7c51e44cb5a9a508de058d563e%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C638954301862839150%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&amp;sdata=3EMBI6Mi82LkwivoABGuFyaLbSV3EVAbPHz3D9DIdBk%3D&amp;reserved=0\">sharedInsight resource type<\/a><\/li>\n<li><a href=\"https:\/\/nam06.safelinks.protection.outlook.com\/?url=https%3A%2F%2Flearn.microsoft.com%2Fen-gb%2Fgraph%2Fapi%2Fresources%2Finsights-resourcevisualization%3Fview%3Dgraph-rest-1.0&amp;data=05%7C02%7Clauragra%40microsoft.com%7C61519c7c51e44cb5a9a508de058d563e%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C638954301862850252%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&amp;sdata=DT8PIMDfv9j6NNenzKByWNrsjPBAiwdWL6B7MEhap%2Fg%3D&amp;reserved=0\">resourceVisualization resource type<\/a><\/li>\n<li><a href=\"https:\/\/nam06.safelinks.protection.outlook.com\/?url=https%3A%2F%2Flearn.microsoft.com%2Fen-gb%2Fgraph%2Fapi%2Fdriveitem-preview%3Fview%3Dgraph-rest-1.0&amp;data=05%7C02%7Clauragra%40microsoft.com%7C61519c7c51e44cb5a9a508de058d563e%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C638954301862861373%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&amp;sdata=Vmo1U5MG3yMQHyYSTIjyk0BF5V7ukxLTkzNiKJrC87U%3D&amp;reserved=0\">driveItem: preview<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>The previewImageUrl property is no longer returned for file attachment items.<\/p>\n","protected":false},"author":69077,"featured_media":6844,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1,3],"tags":[],"class_list":["post-24816","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-365-developer","category-microsoft-graph"],"acf":[],"blog_post_summary":"<p>The previewImageUrl property is no longer returned for file attachment items.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/24816","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69077"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=24816"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/24816\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/6844"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=24816"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=24816"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=24816"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}