{"id":3442,"date":"2026-11-17T10:12:05","date_gmt":"2026-11-17T04:42:05","guid":{"rendered":"https:\/\/larapush.com\/blog\/?p=3442"},"modified":"2026-11-17T10:12:05","modified_gmt":"2026-11-17T04:42:05","slug":"add-images-to-web-push-notifications","status":"publish","type":"post","link":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/","title":{"rendered":"How to Add Images to Web Push Notifications"},"content":{"rendered":"\n<p><strong>To add an image to a web push notification, set the image option to an HTTPS image URL when the service worker calls showNotification, or fill the image field in your push tool.<\/strong> Chrome, Edge and Opera show it as a large picture on Windows and Android. Firefox and Safari ignore it, so the text must work on its own.<\/p>\n\n\n\n<p>A web push notification image is the large picture under the text, separate from the small icon. It makes a notification easier to notice in a crowded tray. However, support is uneven, so I treat it as an extra, never as the message itself. Below I cover where images show, the right sizes, the code and the common reasons an image doesn&#8217;t appear.<\/p>\n\n\n\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_63 counter-hierarchy ez-toc-counter ez-toc-grey ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title \" >Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"Toggle Table of Content\"><span class=\"ez-toc-js-icon-con\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#What_image_options_does_a_web_push_notification_have\" title=\"What image options does a web push notification have?\">What image options does a web push notification have?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#Which_browsers_show_a_large_web_push_image\" title=\"Which browsers show a large web push image?\">Which browsers show a large web push image?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#What_size_should_a_web_push_notification_image_be\" title=\"What size should a web push notification image be?\">What size should a web push notification image be?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#How_do_you_add_an_image_in_code\" title=\"How do you add an image in code?\">How do you add an image in code?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#How_do_you_add_an_image_in_a_push_panel\" title=\"How do you add an image in a push panel?\">How do you add an image in a push panel?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#Why_is_my_web_push_notification_image_not_showing\" title=\"Why is my web push notification image not showing?\">Why is my web push notification image not showing?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#Do_images_make_people_click_more\" title=\"Do images make people click more?\">Do images make people click more?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-8\" href=\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#Where_does_LaraPush_fit\" title=\"Where does LaraPush fit?\">Where does LaraPush fit?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-9\" href=\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#Frequently_asked_questions\" title=\"Frequently asked questions\">Frequently asked questions<\/a><\/li><\/ul><\/nav><\/div>\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"What_image_options_does_a_web_push_notification_have\"><\/span>What image options does a web push notification have?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>A notification can carry three kinds of image: the large image, the icon and the badge. Each has a different job and different browser support.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Option<\/th><th>What it shows<\/th><th>Where it shows (Nov 2026)<\/th><th>Suggested size<\/th><\/tr><\/thead><tbody><tr><td>image<\/td><td>Large picture below the text<\/td><td>Chrome, Edge, Opera (desktop and Android)<\/td><td>1350 px wide or more; 4:3 or 2:1<\/td><\/tr><tr><td>icon<\/td><td>Small square picture next to the title<\/td><td>Most browsers<\/td><td>192 x 192 px or more<\/td><\/tr><tr><td>badge<\/td><td>Small monochrome symbol in the status bar<\/td><td>Chrome on Android<\/td><td>72 x 72 px or more<\/td><\/tr><tr><td>actions[].icon<\/td><td>Small picture on each button<\/td><td>Chrome and Edge, where buttons show<\/td><td>Small square, e.g. 128 x 128 px<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>The support data comes from MDN&#8217;s <a href=\"https:\/\/developer.mozilla.org\/en-US\/docs\/Web\/API\/ServiceWorkerRegistration\/showNotification#browser_compatibility\" target=\"_blank\" rel=\"noreferrer noopener\">showNotification() compatibility table<\/a>, which lists the image option as supported in Chrome since version 56 and not supported in Firefox or Safari. For buttons, see my guide to <a href=\"https:\/\/larapush.com\/blog\/push-notification-cta-buttons\/\">push notification CTA buttons<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Which_browsers_show_a_large_web_push_image\"><\/span>Which browsers show a large web push image?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>Chromium browsers show it: Chrome, Microsoft Edge and Opera. Firefox doesn&#8217;t support the image option on any platform, and Safari doesn&#8217;t either, including web push on iPhone and iPad from iOS 16.4.<\/p>\n\n\n\n<p>Even within Chromium, the operating system has the final say. On Android, the image usually appears when the notification is expanded. On macOS, Chrome hands notifications to the system notification centre, which doesn&#8217;t show the large image the way Windows does. So a big share of your subscribers will never see it, and that&#8217;s why the text has to stand on its own. My <a href=\"https:\/\/larapush.com\/blog\/browsers-that-support-web-push\/\">list of browsers that support web push<\/a> covers the wider support picture.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"What_size_should_a_web_push_notification_image_be\"><\/span>What size should a web push notification image be?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>Use a light, compressed landscape image at least 1350 pixels wide, with the important part in the centre. That guidance comes from the Chrome team&#8217;s article on <a href=\"https:\/\/web.dev\/articles\/push-notifications-display-a-notification\" target=\"_blank\" rel=\"noreferrer noopener\">displaying a notification<\/a>, which says Android&#8217;s only guideline is a 450dp width, so 1350 px covers a device pixel ratio of 3.<\/p>\n\n\n\n<p>The same article notes that desktop Chrome uses a 4:3 ratio while Android crops differently, so there&#8217;s no single perfect shape. In practice, I use these rules:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Ratio:<\/strong> 2:1 or 4:3 landscape, such as 1350 x 675 or 1440 x 1080.<\/li>\n\n\n\n<li><strong>Safe area:<\/strong> keep faces, products and key details in the middle; edges get cropped.<\/li>\n\n\n\n<li><strong>No text in the image:<\/strong> small text becomes unreadable, and the notification already has a title.<\/li>\n\n\n\n<li><strong>Format:<\/strong> JPG or PNG; WebP works in current Chromium browsers.<\/li>\n\n\n\n<li><strong>Weight:<\/strong> compress it. The browser downloads it when the notification arrives, often on mobile data.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"How_do_you_add_an_image_in_code\"><\/span>How do you add an image in code?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>Pass the image URL in your push payload, then set the image option in the service worker&#8217;s showNotification call. The browser fetches the image itself, so the payload only carries the URL.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>\/\/ sw.js\nself.addEventListener('push', (event) =&gt; {\n  const data = event.data ? event.data.json() : {};\n  event.waitUntil(\n    self.registration.showNotification(data.title, {\n      body: data.body,\n      icon: data.icon || '\/icon-192.png',   \/\/ small square icon\n      image: data.image,                    \/\/ large picture, HTTPS URL\n      badge: '\/badge-72.png',               \/\/ monochrome, Android status bar\n      data: { url: data.url }\n    })\n  );\n});<\/code><\/pre>\n\n\n\n<p>On the server, add the field to the JSON you already send, for example {&#8220;title&#8221;: &#8220;&#8230;&#8221;, &#8220;body&#8221;: &#8220;&#8230;&#8221;, &#8220;image&#8221;: &#8220;https:\/\/example.com\/push\/sale-1350&#215;675.jpg&#8221;, &#8220;url&#8221;: &#8220;&#8230;&#8221;}. Don&#8217;t embed the image as base64 in the payload. Push services only have to accept 4,096 bytes per message under <a href=\"https:\/\/www.rfc-editor.org\/rfc\/rfc8030\" target=\"_blank\" rel=\"noreferrer noopener\">RFC 8030<\/a>, so a URL is the only practical option. The rest of the setup is in my guide to <a href=\"https:\/\/larapush.com\/blog\/service-worker-for-web-push\/\">the service worker for web push<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"How_do_you_add_an_image_in_a_push_panel\"><\/span>How do you add an image in a push panel?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>In most push panels, you paste an image URL or upload a file in the campaign editor, and the panel adds it to the payload for you. A live preview then shows roughly how it will look.<\/p>\n\n\n\n<p>Here&#8217;s the usual flow:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Create a new campaign and write the title and message first.<\/li>\n\n\n\n<li>Add the large image by URL or upload, using a 1350 px wide landscape file.<\/li>\n\n\n\n<li>Set the icon, often your logo, if the panel doesn&#8217;t use a default.<\/li>\n\n\n\n<li>Check the preview, then send a test to your own Chrome and Firefox browsers.<\/li>\n\n\n\n<li>Send or schedule the campaign once both versions read well.<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Why_is_my_web_push_notification_image_not_showing\"><\/span>Why is my web push notification image not showing?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>Usually because the subscriber&#8217;s browser or operating system doesn&#8217;t support it, not because of your code. Check these causes in order:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Cause<\/th><th>How to check<\/th><th>Fix<\/th><\/tr><\/thead><tbody><tr><td>Firefox or Safari subscriber<\/td><td>Test in Chrome on Windows or Android<\/td><td>Nothing to fix; write for text-only<\/td><\/tr><tr><td>macOS system notifications<\/td><td>Test on Windows or Android<\/td><td>Expected; text must carry the message<\/td><\/tr><tr><td>Image URL not HTTPS or blocked<\/td><td>Open the URL in a private window<\/td><td>Use a public HTTPS URL; check hotlink protection<\/td><\/tr><tr><td>Image too slow or too large<\/td><td>Check file size<\/td><td>Compress; serve from a fast CDN<\/td><\/tr><tr><td>Image not in the payload<\/td><td>Log event.data in the service worker<\/td><td>Add the image field on the server<\/td><\/tr><tr><td>Android notification collapsed<\/td><td>Expand the notification<\/td><td>Expected on some devices<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>If notifications don&#8217;t appear at all, the problem is elsewhere. My guide to <a href=\"https:\/\/larapush.com\/blog\/web-push-notifications-not-showing\/\">web push notifications not showing<\/a> covers that.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Do_images_make_people_click_more\"><\/span>Do images make people click more?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>They can, but I wouldn&#8217;t trust a single universal number. Results depend on your audience, the browser mix and the picture itself. Since many subscribers never see the image, the honest way to find out is to test it on your own list: send the same message with and without an image to two random halves, then compare click-through rate. My guide to <a href=\"https:\/\/larapush.com\/blog\/push-notification-ab-testing\/\">push notification A\/B testing<\/a> explains how to set that up.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Where_does_LaraPush_fit\"><\/span>Where does LaraPush fit?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>LaraPush supports images in its campaign editor. Manual campaigns let you set a custom title, message, image, link and icon, with a live preview and a test send before the campaign goes out. Quick Push fetches the title, description and image from a page URL you paste. See the <a href=\"https:\/\/larapush.com\/features\/\">features overview<\/a> and the <a href=\"https:\/\/larapush.com\/guide\/\">setup guide<\/a>.<\/p>\n\n\n\n<p>LaraPush is self-hosted, so you run your own VPS, the licence covers one server, and there&#8217;s no free plan. Plans start from $499 one-time; check the <a href=\"https:\/\/larapush.com\/pricing\/\">pricing page<\/a> for current prices. For more ideas on what to send, see my <a href=\"https:\/\/larapush.com\/blog\/web-push-notification-examples\/\">web push notification examples<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Frequently_asked_questions\"><\/span>Frequently asked questions<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<div class=\"schema-faq wp-block-yoast-faq-block\"><div class=\"schema-faq-section\" id=\"faq-question-1763373000000\"><strong class=\"schema-faq-question\">What is the best image size for web push notifications?<\/strong> <p class=\"schema-faq-answer\">Use a landscape image at least 1350 pixels wide, in a 2:1 or 4:3 ratio, such as 1350 x 675. Keep the main subject in the centre, avoid text inside the image, and compress the file so it loads fast on mobile data.<\/p> <\/div> <div class=\"schema-faq-section\" id=\"faq-question-1763373001111\"><strong class=\"schema-faq-question\">Do web push images show on iPhone?<\/strong> <p class=\"schema-faq-answer\">No. Safari doesn&#8217;t support the image option, including web push for Home Screen web apps on iOS 16.4 and later. iPhone subscribers see the title, body and icon, so the text must carry the message without the picture.<\/p> <\/div> <div class=\"schema-faq-section\" id=\"faq-question-1763373002222\"><strong class=\"schema-faq-question\">Does Firefox show large images in push notifications?<\/strong> <p class=\"schema-faq-answer\">No. Firefox doesn&#8217;t support the image option of showNotification on desktop or Android. It still shows the title, body and icon, so write every notification to make sense without the large picture.<\/p> <\/div> <div class=\"schema-faq-section\" id=\"faq-question-1763373003333\"><strong class=\"schema-faq-question\">What is the difference between the icon and the image?<\/strong> <p class=\"schema-faq-answer\">The icon is a small square picture next to the title, often your logo, and most browsers show it. The image is a large picture below the text, shown mainly by Chromium browsers. Use both, with the icon at 192 x 192 pixels or more.<\/p> <\/div> <div class=\"schema-faq-section\" id=\"faq-question-1763373004444\"><strong class=\"schema-faq-question\">Can I put an image directly inside the push payload?<\/strong> <p class=\"schema-faq-answer\">Not in practice. Push services only have to accept payloads of 4,096 bytes, which is too small for most images. Send an HTTPS image URL in the payload instead, and let the browser download the picture when the notification arrives.<\/p> <\/div><\/div>\n","protected":false},"excerpt":{"rendered":"How to add images to web push notifications: image vs icon vs badge, browser support, the right size, service worker code and fixes.","protected":false},"author":7,"featured_media":3452,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","csco_display_header_overlay":false,"csco_singular_sidebar":"","csco_page_header_type":""},"categories":[68],"tags":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v22.2 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>How to Add Images to Web Push Notifications<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to Add Images to Web Push Notifications\" \/>\n<meta property=\"og:description\" content=\"How to add images to web push notifications: image vs icon vs badge, browser support, the right size, service worker code and fixes.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/\" \/>\n<meta property=\"og:site_name\" content=\"LaraPush Blog\" \/>\n<meta property=\"article:published_time\" content=\"2026-11-17T04:42:05+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/larapush.com\/blog\/wp-content\/uploads\/2026\/11\/add-images-to-web-push-notifications.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"675\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Ritesh Das\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Ritesh Das\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/\"},\"author\":{\"name\":\"Ritesh Das\",\"@id\":\"https:\/\/larapush.com\/blog\/#\/schema\/person\/4f23894f98426ea3a6bd617e59f03bbd\"},\"headline\":\"How to Add Images to Web Push Notifications\",\"datePublished\":\"2026-11-17T04:42:05+00:00\",\"dateModified\":\"2026-11-17T04:42:05+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/\"},\"wordCount\":1348,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/larapush.com\/blog\/#organization\"},\"image\":{\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/larapush.com\/blog\/wp-content\/uploads\/2026\/11\/add-images-to-web-push-notifications.jpg\",\"articleSection\":[\"How to\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#respond\"]}]},{\"@type\":[\"WebPage\",\"FAQPage\"],\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/\",\"url\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/\",\"name\":\"How to Add Images to Web Push Notifications\",\"isPartOf\":{\"@id\":\"https:\/\/larapush.com\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/larapush.com\/blog\/wp-content\/uploads\/2026\/11\/add-images-to-web-push-notifications.jpg\",\"datePublished\":\"2026-11-17T04:42:05+00:00\",\"dateModified\":\"2026-11-17T04:42:05+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#breadcrumb\"},\"mainEntity\":[{\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373000000\"},{\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373001111\"},{\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373002222\"},{\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373003333\"},{\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373004444\"}],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#primaryimage\",\"url\":\"https:\/\/larapush.com\/blog\/wp-content\/uploads\/2026\/11\/add-images-to-web-push-notifications.jpg\",\"contentUrl\":\"https:\/\/larapush.com\/blog\/wp-content\/uploads\/2026\/11\/add-images-to-web-push-notifications.jpg\",\"width\":1200,\"height\":675,\"caption\":\"Illustration of a web push notification image shown on a desktop and a phone\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/larapush.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to Add Images to Web Push Notifications\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/larapush.com\/blog\/#website\",\"url\":\"https:\/\/larapush.com\/blog\/\",\"name\":\"LaraPush Blog\",\"description\":\"Stay Ahead, Stay Notified with LaraPush!\",\"publisher\":{\"@id\":\"https:\/\/larapush.com\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/larapush.com\/blog\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/larapush.com\/blog\/#organization\",\"name\":\"LaraPush\",\"url\":\"https:\/\/larapush.com\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/larapush.com\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/larapush.com\/blog\/wp-content\/uploads\/2022\/05\/LARAPUSH.png\",\"contentUrl\":\"https:\/\/larapush.com\/blog\/wp-content\/uploads\/2022\/05\/LARAPUSH.png\",\"width\":280,\"height\":60,\"caption\":\"LaraPush\"},\"image\":{\"@id\":\"https:\/\/larapush.com\/blog\/#\/schema\/logo\/image\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\/\/larapush.com\/blog\/#\/schema\/person\/4f23894f98426ea3a6bd617e59f03bbd\",\"name\":\"Ritesh Das\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/larapush.com\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/1bd7bb0ba68e36b218587b72e89e511f?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/1bd7bb0ba68e36b218587b72e89e511f?s=96&d=mm&r=g\",\"caption\":\"Ritesh Das\"},\"url\":\"https:\/\/larapush.com\/blog\/author\/riteshdas\/\"},{\"@type\":\"Question\",\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373000000\",\"position\":1,\"url\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373000000\",\"name\":\"What is the best image size for web push notifications?\",\"answerCount\":1,\"acceptedAnswer\":{\"@type\":\"Answer\",\"text\":\"Use a landscape image at least 1350 pixels wide, in a 2:1 or 4:3 ratio, such as 1350 x 675. Keep the main subject in the centre, avoid text inside the image, and compress the file so it loads fast on mobile data.\",\"inLanguage\":\"en-US\"},\"inLanguage\":\"en-US\"},{\"@type\":\"Question\",\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373001111\",\"position\":2,\"url\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373001111\",\"name\":\"Do web push images show on iPhone?\",\"answerCount\":1,\"acceptedAnswer\":{\"@type\":\"Answer\",\"text\":\"No. Safari doesn't support the image option, including web push for Home Screen web apps on iOS 16.4 and later. iPhone subscribers see the title, body and icon, so the text must carry the message without the picture.\",\"inLanguage\":\"en-US\"},\"inLanguage\":\"en-US\"},{\"@type\":\"Question\",\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373002222\",\"position\":3,\"url\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373002222\",\"name\":\"Does Firefox show large images in push notifications?\",\"answerCount\":1,\"acceptedAnswer\":{\"@type\":\"Answer\",\"text\":\"No. Firefox doesn't support the image option of showNotification on desktop or Android. It still shows the title, body and icon, so write every notification to make sense without the large picture.\",\"inLanguage\":\"en-US\"},\"inLanguage\":\"en-US\"},{\"@type\":\"Question\",\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373003333\",\"position\":4,\"url\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373003333\",\"name\":\"What is the difference between the icon and the image?\",\"answerCount\":1,\"acceptedAnswer\":{\"@type\":\"Answer\",\"text\":\"The icon is a small square picture next to the title, often your logo, and most browsers show it. The image is a large picture below the text, shown mainly by Chromium browsers. Use both, with the icon at 192 x 192 pixels or more.\",\"inLanguage\":\"en-US\"},\"inLanguage\":\"en-US\"},{\"@type\":\"Question\",\"@id\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373004444\",\"position\":5,\"url\":\"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373004444\",\"name\":\"Can I put an image directly inside the push payload?\",\"answerCount\":1,\"acceptedAnswer\":{\"@type\":\"Answer\",\"text\":\"Not in practice. Push services only have to accept payloads of 4,096 bytes, which is too small for most images. Send an HTTPS image URL in the payload instead, and let the browser download the picture when the notification arrives.\",\"inLanguage\":\"en-US\"},\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How to Add Images to Web Push Notifications","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/","og_locale":"en_US","og_type":"article","og_title":"How to Add Images to Web Push Notifications","og_description":"How to add images to web push notifications: image vs icon vs badge, browser support, the right size, service worker code and fixes.","og_url":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/","og_site_name":"LaraPush Blog","article_published_time":"2026-11-17T04:42:05+00:00","og_image":[{"width":1200,"height":675,"url":"https:\/\/larapush.com\/blog\/wp-content\/uploads\/2026\/11\/add-images-to-web-push-notifications.jpg","type":"image\/jpeg"}],"author":"Ritesh Das","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Ritesh Das","Est. reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#article","isPartOf":{"@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/"},"author":{"name":"Ritesh Das","@id":"https:\/\/larapush.com\/blog\/#\/schema\/person\/4f23894f98426ea3a6bd617e59f03bbd"},"headline":"How to Add Images to Web Push Notifications","datePublished":"2026-11-17T04:42:05+00:00","dateModified":"2026-11-17T04:42:05+00:00","mainEntityOfPage":{"@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/"},"wordCount":1348,"commentCount":0,"publisher":{"@id":"https:\/\/larapush.com\/blog\/#organization"},"image":{"@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#primaryimage"},"thumbnailUrl":"https:\/\/larapush.com\/blog\/wp-content\/uploads\/2026\/11\/add-images-to-web-push-notifications.jpg","articleSection":["How to"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#respond"]}]},{"@type":["WebPage","FAQPage"],"@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/","url":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/","name":"How to Add Images to Web Push Notifications","isPartOf":{"@id":"https:\/\/larapush.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#primaryimage"},"image":{"@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#primaryimage"},"thumbnailUrl":"https:\/\/larapush.com\/blog\/wp-content\/uploads\/2026\/11\/add-images-to-web-push-notifications.jpg","datePublished":"2026-11-17T04:42:05+00:00","dateModified":"2026-11-17T04:42:05+00:00","breadcrumb":{"@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#breadcrumb"},"mainEntity":[{"@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373000000"},{"@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373001111"},{"@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373002222"},{"@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373003333"},{"@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373004444"}],"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#primaryimage","url":"https:\/\/larapush.com\/blog\/wp-content\/uploads\/2026\/11\/add-images-to-web-push-notifications.jpg","contentUrl":"https:\/\/larapush.com\/blog\/wp-content\/uploads\/2026\/11\/add-images-to-web-push-notifications.jpg","width":1200,"height":675,"caption":"Illustration of a web push notification image shown on a desktop and a phone"},{"@type":"BreadcrumbList","@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/larapush.com\/blog\/"},{"@type":"ListItem","position":2,"name":"How to Add Images to Web Push Notifications"}]},{"@type":"WebSite","@id":"https:\/\/larapush.com\/blog\/#website","url":"https:\/\/larapush.com\/blog\/","name":"LaraPush Blog","description":"Stay Ahead, Stay Notified with LaraPush!","publisher":{"@id":"https:\/\/larapush.com\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/larapush.com\/blog\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/larapush.com\/blog\/#organization","name":"LaraPush","url":"https:\/\/larapush.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/larapush.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/larapush.com\/blog\/wp-content\/uploads\/2022\/05\/LARAPUSH.png","contentUrl":"https:\/\/larapush.com\/blog\/wp-content\/uploads\/2022\/05\/LARAPUSH.png","width":280,"height":60,"caption":"LaraPush"},"image":{"@id":"https:\/\/larapush.com\/blog\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/larapush.com\/blog\/#\/schema\/person\/4f23894f98426ea3a6bd617e59f03bbd","name":"Ritesh Das","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/larapush.com\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/1bd7bb0ba68e36b218587b72e89e511f?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/1bd7bb0ba68e36b218587b72e89e511f?s=96&d=mm&r=g","caption":"Ritesh Das"},"url":"https:\/\/larapush.com\/blog\/author\/riteshdas\/"},{"@type":"Question","@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373000000","position":1,"url":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373000000","name":"What is the best image size for web push notifications?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"Use a landscape image at least 1350 pixels wide, in a 2:1 or 4:3 ratio, such as 1350 x 675. Keep the main subject in the centre, avoid text inside the image, and compress the file so it loads fast on mobile data.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373001111","position":2,"url":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373001111","name":"Do web push images show on iPhone?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"No. Safari doesn't support the image option, including web push for Home Screen web apps on iOS 16.4 and later. iPhone subscribers see the title, body and icon, so the text must carry the message without the picture.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373002222","position":3,"url":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373002222","name":"Does Firefox show large images in push notifications?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"No. Firefox doesn't support the image option of showNotification on desktop or Android. It still shows the title, body and icon, so write every notification to make sense without the large picture.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373003333","position":4,"url":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373003333","name":"What is the difference between the icon and the image?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"The icon is a small square picture next to the title, often your logo, and most browsers show it. The image is a large picture below the text, shown mainly by Chromium browsers. Use both, with the icon at 192 x 192 pixels or more.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373004444","position":5,"url":"https:\/\/larapush.com\/blog\/add-images-to-web-push-notifications\/#faq-question-1763373004444","name":"Can I put an image directly inside the push payload?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"Not in practice. Push services only have to accept payloads of 4,096 bytes, which is too small for most images. Send an HTTPS image URL in the payload instead, and let the browser download the picture when the notification arrives.","inLanguage":"en-US"},"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/larapush.com\/blog\/wp-json\/wp\/v2\/posts\/3442"}],"collection":[{"href":"https:\/\/larapush.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/larapush.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/larapush.com\/blog\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/larapush.com\/blog\/wp-json\/wp\/v2\/comments?post=3442"}],"version-history":[{"count":1,"href":"https:\/\/larapush.com\/blog\/wp-json\/wp\/v2\/posts\/3442\/revisions"}],"predecessor-version":[{"id":3447,"href":"https:\/\/larapush.com\/blog\/wp-json\/wp\/v2\/posts\/3442\/revisions\/3447"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/larapush.com\/blog\/wp-json\/wp\/v2\/media\/3452"}],"wp:attachment":[{"href":"https:\/\/larapush.com\/blog\/wp-json\/wp\/v2\/media?parent=3442"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/larapush.com\/blog\/wp-json\/wp\/v2\/categories?post=3442"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/larapush.com\/blog\/wp-json\/wp\/v2\/tags?post=3442"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}