<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Jay Barker</title>
    <description>The latest articles on DEV Community by Jay Barker (@jaybarker).</description>
    <link>https://dev.to/jaybarker</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F3517117%2Ff15639e8-7359-4295-aaee-a51c1d47a6b5.png</url>
      <title>DEV Community: Jay Barker</title>
      <link>https://dev.to/jaybarker</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/jaybarker"/>
    <language>en</language>
    <item>
      <title>Reels Hook Timing: Showing a Brand Logo in the First Second</title>
      <dc:creator>Jay Barker</dc:creator>
      <pubDate>Sat, 14 Nov 2026 15:48:00 +0000</pubDate>
      <link>https://dev.to/jaybarker/reels-hook-timing-showing-a-brand-logo-in-the-first-second-26gj</link>
      <guid>https://dev.to/jaybarker/reels-hook-timing-showing-a-brand-logo-in-the-first-second-26gj</guid>
      <description>&lt;p&gt;Your team just finished a beautiful two-second logo animation. It spins, it glows, it lands with a satisfying whoosh. So you put it at the start of every Reel. A week later, you check your insights and notice something uncomfortable: people are swiping away before the logo even finishes.&lt;/p&gt;

&lt;p&gt;On Instagram Reels, the first second is the most valuable real estate you have. Viewers decide almost instantly whether to keep watching, and a logo they didn't ask for is rarely a reason to stay.&lt;/p&gt;

&lt;p&gt;But that doesn't mean your brand has to hide until the end. This post covers when a brand logo in the first second genuinely helps, when it hurts, five ways to brand the opening without killing your hook, safe placement and some tested ffmpeg commands to put a logo exactly where and when you want it.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Short Answer
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;The hook comes first.&lt;/strong&gt; The opening second should give viewers a reason to stay: a question, a result, a surprising visual or a bold claim.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A logo can live inside the first second&lt;/strong&gt; without replacing the hook, as a small corner mark, a branded frame or the product itself.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Save the full logo animation for the end,&lt;/strong&gt; or skip it.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Paid ads are different from organic posts.&lt;/strong&gt; In ads, early branding often matters more.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Test with your own data,&lt;/strong&gt; because what works depends on your audience and how well people already know your brand.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  What the First Second Actually Decides
&lt;/h2&gt;

&lt;p&gt;Reels are built for fast decisions. Viewers scroll with their thumb ready, and anything that doesn't immediately feel relevant gets swiped.&lt;/p&gt;

&lt;p&gt;Instagram has explained that what it shows people depends heavily on predicted engagement. In &lt;a href="https://about.instagram.com/blog/announcements/instagram-ranking-explained" rel="noopener noreferrer"&gt;Instagram's ranking explained, by Adam Mosseri&lt;/a&gt;, published in 2023, Instagram said its most important Reels predictions include "how likely you are to reshare a reel, watch a reel all the way through, like it, and go to the audio page." Every one of those depends on viewers getting past the opening.&lt;/p&gt;

&lt;p&gt;That's why the opening second has one job: earn the next few seconds. A good hook does that. A slow logo reveal usually doesn't, especially for people who've never heard of you.&lt;/p&gt;

&lt;h2&gt;
  
  
  When a Logo in the First Second Helps
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Paid Reels Ads
&lt;/h3&gt;

&lt;p&gt;In ads, brand recall is often part of the goal. If someone watches only two seconds, you still want them to know who the ad was from. Early branding, done lightly, can make even a short view count for something.&lt;/p&gt;

&lt;h3&gt;
  
  
  Brands People Already Recognize
&lt;/h3&gt;

&lt;p&gt;When your logo is familiar, it can work as a signal of quality or relevance. A known coffee brand's cup or a familiar app icon tells viewers what to expect immediately.&lt;/p&gt;

&lt;h3&gt;
  
  
  When the Logo Is the Hook
&lt;/h3&gt;

&lt;p&gt;Sometimes the logo is the interesting thing. Unboxing branded packaging, a logo drawn in latte art, a logo transforming into the product or a sign being installed can all open a Reel with a brand moment that's also a hook.&lt;/p&gt;

&lt;h3&gt;
  
  
  Recurring Series
&lt;/h3&gt;

&lt;p&gt;If you run a regular series, such as a weekly tip or a recurring show, a consistent branded opener helps returning viewers recognize it instantly. Keep it very short.&lt;/p&gt;

&lt;h2&gt;
  
  
  When It Hurts
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Organic Reels reaching new viewers.&lt;/strong&gt; People who don't know you need a reason to care before they see who you are.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A slow sting before any payoff.&lt;/strong&gt; Two or three seconds of logo animation is an eternity in a Reel.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A logo with no context.&lt;/strong&gt; A logo alone doesn't tell viewers why they should watch.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A logo that covers the subject.&lt;/strong&gt; Large overlays can hide the face, product or action that would have hooked people.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Five Ways to Brand the First Second Without Killing the Hook
&lt;/h2&gt;

&lt;h3&gt;
  
  
  1. A Small Corner Logo
&lt;/h3&gt;

&lt;p&gt;Place a small, slightly transparent logo in a corner for the whole Reel, inside the safe zone. It builds recognition quietly while the hook does its work. Keep it small enough that it never competes with the subject.&lt;/p&gt;

&lt;h3&gt;
  
  
  2. A Branded Opening Frame
&lt;/h3&gt;

&lt;p&gt;You don't always need the logo itself. Brand colors, a signature font in your on-screen text or a recognizable visual style can make the first frame feel like yours without delaying anything.&lt;/p&gt;

&lt;h3&gt;
  
  
  3. The Product or Packaging as the Logo
&lt;/h3&gt;

&lt;p&gt;If your product carries your branding, put it in the first frame as part of the action. A hand opening a branded box or pouring from a branded bottle is both the hook and the logo.&lt;/p&gt;

&lt;h3&gt;
  
  
  4. A Sound Logo Under the Hook
&lt;/h3&gt;

&lt;p&gt;Sound matters on Reels. &lt;a href="https://developers.facebook.com/blog/post/2024/11/07/unlock-the-power-of-reel-ads/" rel="noopener noreferrer"&gt;Meta's Reels ads best practices&lt;/a&gt; note that "Over 75% of Reels views on Instagram are sound on." A short audio signature under your opening line can build recognition without taking any screen time.&lt;/p&gt;

&lt;h3&gt;
  
  
  5. A Quick Flash After the Hook Line
&lt;/h3&gt;

&lt;p&gt;Open with the hook, then flash the logo for around half a second once the viewer is engaged, and show the full logo at the end. This gives you early branding without asking new viewers to wait.&lt;/p&gt;

&lt;h2&gt;
  
  
  Timing Templates
&lt;/h2&gt;

&lt;p&gt;These beat sheets are starting points. Adjust them to your content and test the results.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Organic educational Reel&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;0.0s to 1.5s: hook line on screen and spoken, such as "Stop doing this when you edit photos"&lt;/li&gt;
&lt;li&gt;Throughout: small corner logo&lt;/li&gt;
&lt;li&gt;1.5s onward: the tips&lt;/li&gt;
&lt;li&gt;Final 1 to 2 seconds: logo end card with a call to action&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Product ad&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;0.0s: the product in action, with branded packaging visible&lt;/li&gt;
&lt;li&gt;0.0s to 1.0s: hook text, such as "This fixed our 3pm slump"&lt;/li&gt;
&lt;li&gt;Around 1.0s: a quick logo flash or sound logo&lt;/li&gt;
&lt;li&gt;Middle: benefits and proof&lt;/li&gt;
&lt;li&gt;End: logo, offer and call to action&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Recurring series&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;0.0s to 0.5s: a very short branded opener viewers recognize&lt;/li&gt;
&lt;li&gt;0.5s onward: this episode's hook and content&lt;/li&gt;
&lt;li&gt;End: logo and "next week" teaser&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Safe Zones and Specs for Logo Placement
&lt;/h2&gt;

&lt;p&gt;Reels are vertical, full-screen videos, typically produced at 1080×1920 pixels in a 9:16 aspect ratio. Meta's guidance is to "Build for vertical" and to "Put your key messages within the Reels safe zone."&lt;/p&gt;

&lt;p&gt;Instagram places interface elements over Reels: the account name and caption near the bottom, buttons down the right side and other controls near the top. Keep logos and important text away from those areas. For ads, check placement with the safe zone preview in Meta Ads Manager rather than guessing. Your Reel's cover may also be cropped on your profile grid, so check that the logo isn't cut off there.&lt;/p&gt;

&lt;h2&gt;
  
  
  Doing It in Code: ffmpeg Recipes
&lt;/h2&gt;

&lt;p&gt;If you edit Reels in batches or automate production, ffmpeg can add logos precisely. These commands were tested with ffmpeg 6.1 on a 1080×1920 test video and a transparent PNG logo.&lt;/p&gt;

&lt;h3&gt;
  
  
  A Small Corner Logo for the Whole Reel
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;ffmpeg &lt;span class="nt"&gt;-i&lt;/span&gt; reel.mp4 &lt;span class="nt"&gt;-i&lt;/span&gt; logo.png &lt;span class="nt"&gt;-filter_complex&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="s2"&gt;"[1]scale=200:-1,format=rgba,colorchannelmixer=aa=0.8[logo];[0][logo]overlay=x=W-w-60:y=260"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-c&lt;/span&gt;:a copy reel-corner.mp4
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This scales the logo to 200 pixels wide, sets it to 80% opacity and places it 60 pixels from the right edge and 260 pixels from the top, away from the top controls. Adjust the position after previewing on a real phone.&lt;/p&gt;

&lt;h3&gt;
  
  
  A Logo That Shows Only for the First 0.8 Seconds
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;ffmpeg &lt;span class="nt"&gt;-i&lt;/span&gt; reel.mp4 &lt;span class="nt"&gt;-i&lt;/span&gt; logo.png &lt;span class="nt"&gt;-filter_complex&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="s2"&gt;"[1]scale=600:-1[logo];[0][logo]overlay=x=(W-w)/2:y=(H-h)/2:enable='between(t,0,0.8)'"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-c&lt;/span&gt;:a copy reel-flash.mp4
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The &lt;code&gt;enable='between(t,0,0.8)'&lt;/code&gt; option shows the logo only between 0 and 0.8 seconds. In testing, the logo appeared in a frame captured at 0.4 seconds and was gone by 2 seconds. To flash it after a hook line instead, change the times, such as &lt;code&gt;between(t,1.2,1.7)&lt;/code&gt;.&lt;/p&gt;

&lt;h3&gt;
  
  
  Turning a 16:9 Clip Into a 9:16 Reel With a Branded Background
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;ffmpeg &lt;span class="nt"&gt;-i&lt;/span&gt; wide.mp4 &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-vf&lt;/span&gt; &lt;span class="s2"&gt;"scale=1080:-2,pad=1080:1920:(ow-iw)/2:(oh-ih)/2:color=0x1f6f5c,setsar=1"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-c&lt;/span&gt;:v libx264 &lt;span class="nt"&gt;-crf&lt;/span&gt; 20 &lt;span class="nt"&gt;-pix_fmt&lt;/span&gt; yuv420p &lt;span class="nt"&gt;-movflags&lt;/span&gt; +faststart reel-vertical.mp4
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This scales a horizontal clip to 1080 pixels wide, centers it on a 1080×1920 canvas filled with a brand color and outputs a phone-friendly MP4. It's a quick way to repurpose horizontal footage, though footage shot vertically will almost always perform better.&lt;/p&gt;

&lt;p&gt;If your logo animation was delivered as a MOV with an alpha channel, you can use it in place of &lt;code&gt;logo.png&lt;/code&gt; in the overlay commands, and ffmpeg will respect the transparency.&lt;/p&gt;

&lt;h2&gt;
  
  
  Measuring It
&lt;/h2&gt;

&lt;p&gt;Don't decide based on opinions. Reels insights show how viewers behave, including views, watch time and retention, and depending on your account, metrics such as skip rate. Check &lt;a href="https://help.instagram.com/202865988324236/" rel="noopener noreferrer"&gt;Instagram's help article on Reels insights&lt;/a&gt; and your own professional dashboard for the metrics available to you.&lt;/p&gt;

&lt;p&gt;A simple test:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Make two versions&lt;/strong&gt; of the same Reel: one with a first-second logo flash, one with only a corner logo or end card.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Post them at similar times&lt;/strong&gt; on different days, or use Trial Reels if your account has access, which show a Reel to non-followers first.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Compare&lt;/strong&gt; watch time, retention in the first few seconds and shares.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Repeat&lt;/strong&gt; with a few different Reels before deciding, because one result can be noise.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Our earlier guide to five-second channel intros covers the same testing approach for YouTube, where horizontal intros follow different rules.&lt;/p&gt;

&lt;h2&gt;
  
  
  Getting a Reels-Ready Logo Animation Made
&lt;/h2&gt;

&lt;p&gt;If you're commissioning a logo animation for Reels, ask for:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;A 9:16 version,&lt;/strong&gt; not just 16:9&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A very short version,&lt;/strong&gt; around half a second to one second, for quick flashes&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;An end-card version&lt;/strong&gt; with space for a call to action&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A transparent MOV&lt;/strong&gt; for overlays&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A short sound logo&lt;/strong&gt; that matches the animation&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Aegis Animation Studios creates &lt;a href="https://aegisanimationstudios.com/social-media-content" rel="noopener noreferrer"&gt;social media and Reels content&lt;/a&gt;, including branded motion templates and animated captions, and offers &lt;a href="https://aegisanimationstudios.com/youtube-logo-intro" rel="noopener noreferrer"&gt;YouTube logo intros in 16:9 and 9:16&lt;/a&gt; that work for vertical video too. Confirm the formats and lengths you need when you brief them.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQs
&lt;/h2&gt;

&lt;h3&gt;
  
  
  What is a hook in Instagram Reels?
&lt;/h3&gt;

&lt;p&gt;A hook is the opening moment of a Reel that gives viewers a reason to keep watching. It might be a question, a surprising visual, a result shown first, a bold statement or on-screen text that promises something useful. A strong hook appears immediately, usually in the first second or two.&lt;/p&gt;

&lt;h3&gt;
  
  
  How many seconds should a Reels hook be?
&lt;/h3&gt;

&lt;p&gt;There's no official length, but most creators aim to land the hook within the first one to three seconds. The opening frame should already be interesting, because viewers decide almost instantly whether to keep watching or swipe.&lt;/p&gt;

&lt;h3&gt;
  
  
  Should you put your logo at the start of a Reel?
&lt;/h3&gt;

&lt;p&gt;Usually not as a standalone logo animation, especially for organic Reels reaching new viewers. Instead, open with the hook and brand the first second lightly with a small corner logo, branded visuals, your product or a sound logo. Paid ads and well-known brands can benefit from earlier branding.&lt;/p&gt;

&lt;h3&gt;
  
  
  Do logo intros hurt Reels retention?
&lt;/h3&gt;

&lt;p&gt;Long or slow logo intros often do, because they delay the content viewers came for. A very short logo flash after the hook, a corner logo or an end card usually has far less impact. Compare versions in your Reels insights to see what works for your audience.&lt;/p&gt;

&lt;h3&gt;
  
  
  Where should a logo go on a Reel?
&lt;/h3&gt;

&lt;p&gt;Place it inside the safe zone, away from Instagram's interface at the bottom, right side and top of the screen. A small logo in an upper corner, clear of the controls, works well for most Reels. For ads, check placement with the safe zone preview in Meta Ads Manager.&lt;/p&gt;

&lt;h3&gt;
  
  
  What is skip rate on Instagram Reels?
&lt;/h3&gt;

&lt;p&gt;Skip rate is a Reels metric reported by industry sources as the share of viewers who swipe away very quickly. Availability can vary by account, so check your Reels insights. A high skip rate usually means the opening isn't hooking viewers fast enough.&lt;/p&gt;

&lt;h3&gt;
  
  
  How long should an Instagram Reel be?
&lt;/h3&gt;

&lt;p&gt;It depends on your content and audience. Short Reels make it easier for viewers to watch all the way through, while longer Reels can work for tutorials and stories that hold attention. Keep every Reel only as long as it needs to be, and test different lengths.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrapping Up
&lt;/h2&gt;

&lt;p&gt;The first second of a Reel belongs to the hook. Your brand can still be there, as a small corner logo, a branded frame, your product or a sound logo, but a full logo animation usually works better at the end. Use the timing templates as a starting point, place logos inside the safe zone and let your own retention data decide.&lt;/p&gt;

</description>
      <category>video</category>
      <category>marketing</category>
      <category>ffmpeg</category>
      <category>beginners</category>
    </item>
    <item>
      <title>Duplicate Google Business Profiles: Merging and Fixing Listings</title>
      <dc:creator>Jay Barker</dc:creator>
      <pubDate>Fri, 13 Nov 2026 16:40:00 +0000</pubDate>
      <link>https://dev.to/jaybarker/duplicate-google-business-profiles-merging-and-fixing-listings-o03</link>
      <guid>https://dev.to/jaybarker/duplicate-google-business-profiles-merging-and-fixing-listings-o03</guid>
      <description>&lt;p&gt;A customer mentions they left you a glowing review, but you can't find it. Then you search your business name on Google Maps and see the problem: there are two of you. One listing has your current address and most of your reviews. The other has your old address, an outdated phone number and the review you were looking for.&lt;/p&gt;

&lt;p&gt;Duplicate Google Business Profiles are common, and they cause real problems. Reviews split between listings, customers call old numbers and Google may hide the listing you actually want people to see.&lt;/p&gt;

&lt;p&gt;The fix depends on what kind of duplicate you have. This guide covers what Google counts as a duplicate, how to find every one, how to choose which profile to keep and how to fix each type, with a worked example and a small script that flags likely duplicates in a list of listings.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Short Version
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Google allows one profile per business per location,&lt;/strong&gt; with a few exceptions for departments, practitioners and co-located brands.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The right fix depends on the type of duplicate:&lt;/strong&gt; who owns it, whether the address matches and whether it's really the same business.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Merging combines reviews,&lt;/strong&gt; but review replies may be lost.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Removing a profile deletes its content,&lt;/strong&gt; so never remove anything until you know which listing holds the reviews.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Clean up beyond Google too,&lt;/strong&gt; because outdated directory listings can keep feeding bad data back.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  What Google Counts as a Duplicate
&lt;/h2&gt;

&lt;p&gt;Google's position is simple. Its &lt;a href="https://support.google.com/business/answer/3038177?hl=en" rel="noopener noreferrer"&gt;guidelines for representing your business&lt;/a&gt; state: "There should only be one profile per business," and "Do not create more than one page for each location of your business, either in a single account or multiple accounts."&lt;/p&gt;

&lt;p&gt;There are a few legitimate exceptions:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Departments.&lt;/strong&gt; "Publicly-facing departments that operate as distinct entities should have their own page," such as a car dealership's service center, each with a distinct name.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Co-located businesses.&lt;/strong&gt; Separate brands at the same address, such as a restaurant inside a hotel, should each have their own profile.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Practitioners.&lt;/strong&gt; Doctors, lawyers and similar professionals can sometimes have their own profiles, with special rules covered below.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Some locations aren't eligible at all. Google says a virtual office "isn't eligible for a Business Profile," and service-area businesses can't list a virtual office "unless that office is staffed during business hours."&lt;/p&gt;

&lt;p&gt;When Google decides a profile is a duplicate, the consequences are significant. According to &lt;a href="https://support.google.com/business/answer/12756178?hl=en" rel="noopener noreferrer"&gt;Google's help page on profiles marked as duplicate&lt;/a&gt;, "If a profile is considered a duplicate, it won't show on Google Search or Maps."&lt;/p&gt;

&lt;h2&gt;
  
  
  Why Duplicates Happen
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;A move or rebrand,&lt;/strong&gt; where a new profile was created instead of updating the old one&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A former agency or employee&lt;/strong&gt; who created a listing years ago under their own account&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Google itself,&lt;/strong&gt; which can create listings from user suggestions and other data sources&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Practitioner listings&lt;/strong&gt; for individual professionals at a practice&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Tracking phone numbers&lt;/strong&gt; used in old marketing campaigns, which make one business look like two&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A switch between storefront and service-area setups&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Step 1: Find Every Duplicate
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Search Google Maps
&lt;/h3&gt;

&lt;p&gt;Search Google Maps for:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Your business name, plus common variations and old names&lt;/li&gt;
&lt;li&gt;Every phone number you've used, including old and tracking numbers&lt;/li&gt;
&lt;li&gt;Your current and previous addresses&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Note every listing that appears, even ones that look slightly different.&lt;/p&gt;

&lt;h3&gt;
  
  
  Check Business Profile Manager
&lt;/h3&gt;

&lt;p&gt;Sign in to the account that manages your profile and check for any profile showing a "Duplicate" status. If you manage several locations, review each one.&lt;/p&gt;

&lt;h3&gt;
  
  
  Collect Your Listings in One Place
&lt;/h3&gt;

&lt;p&gt;Make a simple spreadsheet of every listing you find, on Google and on major directories, with four columns: source, name, phone and address. Save it as a CSV. It's the input for the script below, and it doubles as your cleanup checklist.&lt;/p&gt;

&lt;h2&gt;
  
  
  A Small Script to Flag Likely Duplicates
&lt;/h2&gt;

&lt;p&gt;Comparing listings by eye is error-prone, because "410 Cedar Ave, Suite 200" and "410 Cedar Avenue Ste 200" look different but mean the same thing. This Node.js script normalizes names, phone numbers and addresses, then groups listings that match on any of them. It has no dependencies:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// find-duplicates.mjs: flag listings that may describe the same business&lt;/span&gt;
&lt;span class="c1"&gt;// Usage: node find-duplicates.mjs listings.csv&lt;/span&gt;
&lt;span class="c1"&gt;// CSV columns: source,name,phone,address (quote fields that contain commas)&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;readFileSync&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;node:fs&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;parseLine&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;line&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;[...&lt;/span&gt;&lt;span class="nx"&gt;line&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;matchAll&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;/&lt;/span&gt;&lt;span class="se"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;"&lt;/span&gt;&lt;span class="se"&gt;([^&lt;/span&gt;&lt;span class="sr"&gt;"&lt;/span&gt;&lt;span class="se"&gt;]&lt;/span&gt;&lt;span class="sr"&gt;*&lt;/span&gt;&lt;span class="se"&gt;)&lt;/span&gt;&lt;span class="sr"&gt;"|&lt;/span&gt;&lt;span class="se"&gt;[^&lt;/span&gt;&lt;span class="sr"&gt;,&lt;/span&gt;&lt;span class="se"&gt;]&lt;/span&gt;&lt;span class="sr"&gt;*&lt;/span&gt;&lt;span class="se"&gt;)(&lt;/span&gt;&lt;span class="sr"&gt;,|$&lt;/span&gt;&lt;span class="se"&gt;)&lt;/span&gt;&lt;span class="sr"&gt;/g&lt;/span&gt;&lt;span class="p"&gt;)].&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;m&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;m&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="nx"&gt;m&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;]).&lt;/span&gt;&lt;span class="nf"&gt;slice&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[,&lt;/span&gt; &lt;span class="p"&gt;...&lt;/span&gt;&lt;span class="nx"&gt;rows&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;readFileSync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;utf8&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;trim&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;split&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="se"&gt;\n&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;listings&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;rows&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;line&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;source&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;phone&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;address&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;parseLine&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;line&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;source&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;phone&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;address&lt;/span&gt; &lt;span class="p"&gt;};&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;STOP&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sr"&gt;/&lt;/span&gt;&lt;span class="se"&gt;\b(&lt;/span&gt;&lt;span class="sr"&gt;llc|inc|co|the|and|dds|md|pllc&lt;/span&gt;&lt;span class="se"&gt;)\b&lt;/span&gt;&lt;span class="sr"&gt;/g&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;ABBR&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;street&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;st&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;avenue&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;ave&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;road&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;rd&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;suite&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;ste&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;drive&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;dr&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;boulevard&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;blvd&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;};&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;norm&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;s&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;s&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toLowerCase&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;replace&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;/&lt;/span&gt;&lt;span class="se"&gt;[^&lt;/span&gt;&lt;span class="sr"&gt;a-z0-9 &lt;/span&gt;&lt;span class="se"&gt;]&lt;/span&gt;&lt;span class="sr"&gt;/g&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt; &lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;replace&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;STOP&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt; &lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;replace&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;/&lt;/span&gt;&lt;span class="se"&gt;\s&lt;/span&gt;&lt;span class="sr"&gt;+/g&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt; &lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;trim&lt;/span&gt;&lt;span class="p"&gt;(),&lt;/span&gt;
  &lt;span class="na"&gt;phone&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;s&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;s&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;replace&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;/&lt;/span&gt;&lt;span class="se"&gt;\D&lt;/span&gt;&lt;span class="sr"&gt;/g&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;''&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;slice&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="mi"&gt;10&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
  &lt;span class="na"&gt;address&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;s&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
    &lt;span class="nx"&gt;s&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toLowerCase&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;replace&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;/#/g&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt; ste &lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;replace&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;/&lt;/span&gt;&lt;span class="se"&gt;[^&lt;/span&gt;&lt;span class="sr"&gt;a-z0-9 &lt;/span&gt;&lt;span class="se"&gt;]&lt;/span&gt;&lt;span class="sr"&gt;/g&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt; &lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
      &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;split&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;/&lt;/span&gt;&lt;span class="se"&gt;\s&lt;/span&gt;&lt;span class="sr"&gt;+/&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;Boolean&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;w&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;ABBR&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;w&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="nx"&gt;w&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt; &lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
&lt;span class="p"&gt;};&lt;/span&gt;

&lt;span class="c1"&gt;// Union-find: group listings that share a normalized phone, name or street address&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;parent&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;listings&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;_&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;find&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;parent&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;parent&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;find&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;parent&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;])));&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;reasons&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Map&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;

&lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="nx"&gt;listings&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;j&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;j&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="nx"&gt;listings&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;j&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;a&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;listings&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="nx"&gt;b&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;listings&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;j&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="nx"&gt;why&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[];&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;norm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;phone&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;a&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;phone&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nx"&gt;norm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;phone&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;phone&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="nx"&gt;why&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;phone&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;norm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;name&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;a&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nx"&gt;norm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;name&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="nx"&gt;why&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;name&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;norm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;address&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;a&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;address&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nx"&gt;norm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;address&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;address&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="nx"&gt;why&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;address&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;why&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nx"&gt;parent&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nf"&gt;find&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;j&lt;/span&gt;&lt;span class="p"&gt;)]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;find&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
      &lt;span class="nx"&gt;reasons&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;set&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;-&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;j&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;why&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;groups&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{};&lt;/span&gt;
&lt;span class="nx"&gt;listings&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;forEach&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;_&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;groups&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nf"&gt;find&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;)]&lt;/span&gt; &lt;span class="o"&gt;??=&lt;/span&gt; &lt;span class="p"&gt;[]).&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;

&lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;members&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nb"&gt;Object&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;values&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;groups&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;g&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;g&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="se"&gt;\n&lt;/span&gt;&lt;span class="s1"&gt;Possible duplicates:&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nx"&gt;members&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;forEach&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`  [&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;] &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;listings&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="nx"&gt;source&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;listings&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;, &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;listings&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="nx"&gt;phone&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;, &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;listings&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="nx"&gt;address&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;key&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;why&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;reasons&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;j&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;key&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;split&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;-&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;Number&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;members&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;includes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`    &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; and &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;j&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; match on &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;why&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt; + &lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;singles&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Object&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;values&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;groups&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;g&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;g&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;flat&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;singles&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`\nNo match found: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;singles&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;listings&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;, &lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Here's a sample &lt;code&gt;listings.csv&lt;/code&gt; for the fictional Oakline Dental, including a physical therapy clinic in the same building:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;source,name,phone,address
Google (verified),Oakline Dental,(512) 555-0142,"410 Cedar Ave, Suite 200, Millbrook"
Google (old),Oakline Dental,(512) 555-0142,"88 River Rd, Millbrook"
Google (practitioner),Dr. Maya Ortiz DDS,(512) 555-0142,"410 Cedar Avenue Ste 200, Millbrook"
Google (unverified),Oakline Dental Care LLC,512-555-0199,"410 Cedar Ave #200, Millbrook"
Yelp,Oakline Dental,+1 512 555 0199,"88 River Road, Millbrook"
Directory,Cedar Physical Therapy,(512) 555-0177,"410 Cedar Ave, Suite 210, Millbrook"
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Running &lt;code&gt;node find-duplicates.mjs listings.csv&lt;/code&gt; prints:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Possible duplicates:
  [0] Google (verified): Oakline Dental, (512) 555-0142, 410 Cedar Ave, Suite 200, Millbrook
  [1] Google (old): Oakline Dental, (512) 555-0142, 88 River Rd, Millbrook
  [2] Google (practitioner): Dr. Maya Ortiz DDS, (512) 555-0142, 410 Cedar Avenue Ste 200, Millbrook
  [3] Google (unverified): Oakline Dental Care LLC, 512-555-0199, 410 Cedar Ave #200, Millbrook
  [4] Yelp: Oakline Dental, +1 512 555 0199, 88 River Road, Millbrook
    0 and 1 match on phone + name
    0 and 2 match on phone + address
    0 and 3 match on address
    0 and 4 match on name
    1 and 2 match on phone
    1 and 4 match on name + address
    2 and 3 match on address
    3 and 4 match on phone

No match found: Cedar Physical Therapy
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The script grouped all five Oakline listings, even though the formats differed ("#200" vs "Suite 200," "+1 512" vs "(512)"), and correctly left the physical therapy clinic in Suite 210 alone. Treat the output as a shortlist to review by hand. A shared address can be a legitimate co-located business, and a shared phone can be a practitioner who belongs to the practice.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 2: Decide Which Profile to Keep
&lt;/h2&gt;

&lt;p&gt;Before you change anything, compare the listings and decide which one should survive. Usually, that's the profile that:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Is verified&lt;/strong&gt; and managed in your account&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Has the most reviews,&lt;/strong&gt; especially recent ones&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Has the correct address, category and hours&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Has been around longest&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Check the reviews on every listing before you act. Google warns that when you remove a profile, "all content and linked managers will be removed." Deleting the wrong one can wipe out years of reviews.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 3: Fix It by Duplicate Type
&lt;/h2&gt;

&lt;h3&gt;
  
  
  You Own Both, Same Business, Same Address
&lt;/h3&gt;

&lt;p&gt;This is the classic case for a merge. Google's help page explains that "When 2 profiles are merged, their reviews are combined, but replies to reviews may be lost," and that profiles must "represent the same business and should have the same info." It also notes that "All merge requests are subject to review."&lt;/p&gt;

&lt;p&gt;If one listing is simply a mistake you created, Google says you can remove it "without affecting your verified listing," but check its reviews first.&lt;/p&gt;

&lt;h3&gt;
  
  
  You Own Both, but One Has an Old Address
&lt;/h3&gt;

&lt;p&gt;After a move, the old listing may still appear at your previous address. &lt;a href="https://www.sterlingsky.ca/can-you-merge-two-google-my-business-listings/" rel="noopener noreferrer"&gt;Sterling Sky's guide to merging Google Business Profiles&lt;/a&gt; explains that merges generally require the "same business at the same location," so listings at different addresses usually need to be moved or removed rather than merged. A move points one listing to another, similar to a 302 redirect, and the old listing disappears from search results.&lt;/p&gt;

&lt;p&gt;If you've also changed your website's URLs as part of the move, our guide to redesigning without losing traffic covers updating your profile's website link and keeping local signals intact.&lt;/p&gt;

&lt;h3&gt;
  
  
  Someone Else Owns the Duplicate
&lt;/h3&gt;

&lt;p&gt;If a former agency, employee or previous owner controls the other listing, request access through Google. According to Google, if the current owner doesn't respond within three days, you may be able to claim the profile, though "The option to claim a profile isn't always available." If your request is denied, you can appeal.&lt;/p&gt;

&lt;p&gt;Once you have ownership, you can merge or remove the duplicate as above.&lt;/p&gt;

&lt;h3&gt;
  
  
  Practitioner Listings
&lt;/h3&gt;

&lt;p&gt;Practitioner listings are a common source of confusion for medical, dental, legal and real estate practices. Google's guidelines say that when a practitioner is the only public-facing professional at a branded location, "it's best for the practitioner to share a Business Profile with the organization," using a name like "[brand/company]: [practitioner name]."&lt;/p&gt;

&lt;p&gt;Practices with several professionals can usually have a profile for the practice and separate profiles for each practitioner. Google also notes that "A practitioner shouldn't have multiple Business Profiles to cover all of their specializations." Sterling Sky points out that reviews can't be transferred from a practitioner listing to the practice listing, so consider that before requesting changes.&lt;/p&gt;

&lt;h3&gt;
  
  
  Separate Businesses Flagged as Duplicates
&lt;/h3&gt;

&lt;p&gt;Sometimes two genuinely different businesses at the same address get flagged. Google says that "To appeal a duplicate status, both businesses must be eligible and distinct from one another." For shared locations, that may mean showing evidence such as permanent signage for each business.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Worked Example: Fixing Oakline Dental
&lt;/h2&gt;

&lt;p&gt;&lt;em&gt;Oakline Dental is a fictional business.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Here's what happened to each of Oakline's listings:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Verified main profile, 410 Cedar Ave:&lt;/strong&gt; kept as the primary listing&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Old listing, 88 River Rd:&lt;/strong&gt; confirmed it was in Oakline's account, checked its reviews, then had it moved to the main profile so customers searching the old address found the new location&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Practitioner listing for Dr. Maya Ortiz:&lt;/strong&gt; as the clinic's only dentist, she shares the main profile, renamed "Oakline Dental: Dr. Maya Ortiz"&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Unverified "Oakline Dental Care LLC":&lt;/strong&gt; created years ago by a former agency, with an old tracking number. Oakline requested access, claimed it after the agency didn't respond, then removed it&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Yelp listing at the old address:&lt;/strong&gt; updated with the current address and phone number&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Local Listing Cleanup Beyond Google
&lt;/h2&gt;

&lt;p&gt;Fixing Google is only half the job. Outdated information elsewhere can confuse customers and feed incorrect data back into Google.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Update major directories&lt;/strong&gt; with your current name, address and phone number&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Retire old tracking numbers,&lt;/strong&gt; or make sure they forward to your main line&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Match your website&lt;/strong&gt; footer, contact page and LocalBusiness schema to your Google profile&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Search for old addresses and numbers&lt;/strong&gt; every few months to catch new duplicates early&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Our guide to local SEO basics for service businesses covers the wider picture.&lt;/p&gt;

&lt;h2&gt;
  
  
  Mistakes to Avoid
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Removing the profile with the reviews&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Creating a brand new profile&lt;/strong&gt; to "start fresh," which usually creates another duplicate&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Adding keywords to your business name,&lt;/strong&gt; which breaks Google's guidelines&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Listing a virtual office&lt;/strong&gt; or mailbox as a location&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Reporting the same issue repeatedly&lt;/strong&gt; instead of following up on your original request&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  When to Get Help
&lt;/h2&gt;

&lt;p&gt;If you manage several locations, inherited a messy set of listings or keep getting stuck in ownership disputes, professional help can save time. Nexi Bloom's &lt;a href="https://nexibloom.com/services/search-engine-optimization-seo" rel="noopener noreferrer"&gt;SEO services&lt;/a&gt; include Google Business Profile optimization and citation work as part of local SEO.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQs
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Can you have two Google Business Profiles for the same business?
&lt;/h3&gt;

&lt;p&gt;Generally, no. Google allows one profile per business per location. Exceptions include separate locations, publicly facing departments with distinct names, separate brands at the same address and some individual practitioners. Creating extra profiles for the same location breaks Google's guidelines.&lt;/p&gt;

&lt;h3&gt;
  
  
  How do I remove a duplicate Google Business Profile?
&lt;/h3&gt;

&lt;p&gt;If you own the duplicate, you can remove it from your account, but check its reviews first, because removal deletes all of its content. If someone else owns it, request access through Google first, then remove it once you have ownership, or request a merge if it's the same business at the same address.&lt;/p&gt;

&lt;h3&gt;
  
  
  Can you merge two Google Business Profiles?
&lt;/h3&gt;

&lt;p&gt;Yes, when both profiles represent the same business at the same location and have the same information. Google combines the reviews when profiles are merged, though replies to reviews may be lost, and every merge request is reviewed. Listings at different addresses usually need to be moved or removed instead.&lt;/p&gt;

&lt;h3&gt;
  
  
  What happens to reviews when Google Business Profiles are merged?
&lt;/h3&gt;

&lt;p&gt;Google says reviews are combined when two profiles are merged, but replies to those reviews may be lost. If you remove a profile instead of merging it, its reviews are deleted, so always choose carefully and check which listing holds the reviews you want to keep.&lt;/p&gt;

&lt;h3&gt;
  
  
  Why is my Google Business Profile marked as a duplicate?
&lt;/h3&gt;

&lt;p&gt;Google marks a profile as a duplicate when it believes another profile already represents the same business, such as a verified profile at the same address. Duplicate profiles don't show on Search or Maps. If your business is genuinely separate, you can appeal with evidence.&lt;/p&gt;

&lt;h3&gt;
  
  
  How do I report a duplicate listing I don't own?
&lt;/h3&gt;

&lt;p&gt;Search for the listing on Google Maps and use the option to suggest an edit or report a problem, such as marking it as a duplicate. If it represents your business, request ownership instead, so you can manage, merge or remove it yourself.&lt;/p&gt;

&lt;h3&gt;
  
  
  How long does it take Google to fix a duplicate listing?
&lt;/h3&gt;

&lt;p&gt;It varies. Ownership requests give the current owner three days to respond, and merge requests and edits are reviewed before they take effect. Follow up through Google Business Profile support if nothing changes after a reasonable wait, rather than submitting the same request repeatedly.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrapping Up
&lt;/h2&gt;

&lt;p&gt;Duplicate Google Business Profiles are fixable once you know what you're dealing with. Find every listing, decide which profile to keep based on verification and reviews, then merge, move, claim or remove each duplicate according to its type. Finish by cleaning up directories and your website, and check again every few months so new duplicates don't creep back in.&lt;/p&gt;

</description>
      <category>seo</category>
      <category>webdev</category>
      <category>javascript</category>
      <category>beginners</category>
    </item>
    <item>
      <title>Deposit Amounts That Are Normal for Home Projects</title>
      <dc:creator>Jay Barker</dc:creator>
      <pubDate>Thu, 12 Nov 2026 15:56:00 +0000</pubDate>
      <link>https://dev.to/jaybarker/deposit-amounts-that-are-normal-for-home-projects-4534</link>
      <guid>https://dev.to/jaybarker/deposit-amounts-that-are-normal-for-home-projects-4534</guid>
      <description>&lt;p&gt;The quote for your kitchen remodel looks good. The contractor seems professional, the reviews check out and the timeline works. Then comes the line that makes you pause: "We'll need 50% upfront to lock in your start date."&lt;/p&gt;

&lt;p&gt;Is that normal? Sometimes a large deposit is reasonable, especially when custom materials need ordering. Sometimes it's a warning sign. And in some states, it's simply not allowed.&lt;/p&gt;

&lt;p&gt;This guide covers what a normal contractor deposit amount looks like, which states cap deposits, how to structure a payment schedule that's fair to both sides and what to do if something goes wrong. There's also a small script that drafts a milestone schedule for you.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;This is general information, not legal advice. State rules change, so confirm the current rules where you live.&lt;/em&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  The Short Answer
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;10% to 33% upfront&lt;/strong&gt; is common for many home projects, depending on the job and the state.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Some states cap deposits.&lt;/strong&gt; California limits most home improvement down payments to $1,000 or 10%, whichever is less. Maryland and Massachusetts set limits around one-third.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;More than 50% upfront&lt;/strong&gt; deserves serious questions, unless there's a clear reason such as expensive custom materials.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;After the deposit, payments should follow completed work,&lt;/strong&gt; not the calendar.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Hold back a final payment&lt;/strong&gt; until the job is finished and you've walked through it.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  What a Deposit Actually Pays For
&lt;/h2&gt;

&lt;p&gt;A deposit isn't automatically a red flag. Contractors often have real costs before work starts:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Scheduling.&lt;/strong&gt; Reserving a crew and turning down other jobs for your dates&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Permits.&lt;/strong&gt; Applying for and paying permit fees&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Materials.&lt;/strong&gt; Especially custom or special-order items such as cabinets, countertops, windows and doors, which may be non-returnable&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Planning.&lt;/strong&gt; Measurements, drawings and ordering&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;A reasonable deposit shows commitment on both sides. The question is whether the amount matches those early costs, and whether it's within what your state allows.&lt;/p&gt;

&lt;h2&gt;
  
  
  Typical Deposit Amounts by Project Type
&lt;/h2&gt;

&lt;p&gt;There's no single national standard, but some patterns are common:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Small repairs and service calls:&lt;/strong&gt; often no deposit at all, or just a call-out fee&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Mid-size remodels,&lt;/strong&gt; such as bathrooms and kitchens: often around 10% to 30%, depending on materials and state rules&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Projects with expensive custom materials:&lt;/strong&gt; sometimes more, to cover items ordered specifically for you, where state law permits&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;New construction and major additions:&lt;/strong&gt; usually paid through a draw schedule tied to construction stages, often through a construction loan&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Angi, the home services marketplace, says a deposit of around 10% to 25% is typical where no state limit applies, and notes that "If a contractor asks for more than 50% upfront, this could be a potential red flag."&lt;/p&gt;

&lt;h2&gt;
  
  
  States That Cap Deposits: Verified Examples
&lt;/h2&gt;

&lt;p&gt;Many states regulate home improvement deposits. Here are four examples, checked against official sources in November 2026.&lt;/p&gt;

&lt;h3&gt;
  
  
  California
&lt;/h3&gt;

&lt;p&gt;California has one of the strictest limits. According to &lt;a href="https://www.cslb.ca.gov/Consumers/Hire_A_Contractor/Home_Improvement_Contracts/What_Is_A_Contract.aspx" rel="noopener noreferrer"&gt;the California CSLB's guide to home improvement contracts&lt;/a&gt;, "The down payment cannot be more than $1,000 or 10 percent of the contract price, whichever is less." The CSLB states there's no exception for special-order materials.&lt;/p&gt;

&lt;p&gt;California also limits what comes next: "The payments to the contractor cannot exceed the value of the work performed," apart from the down payment. Contracts must include a written payment schedule.&lt;/p&gt;

&lt;h3&gt;
  
  
  Maryland
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://mgaleg.maryland.gov/mgawebsite/laws/StatuteText?article=gbr&amp;amp;section=8-617" rel="noopener noreferrer"&gt;Maryland's home improvement deposit law&lt;/a&gt; states: "A person may not receive a deposit of more than one-third of the home improvement contract price." The limit applies to deposits taken before or when the contract is signed.&lt;/p&gt;

&lt;h3&gt;
  
  
  Massachusetts
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://www.mass.gov/info-details/home-improvement-contract-requirements-details-and-sample-language" rel="noopener noreferrer"&gt;Massachusetts home improvement contract requirements&lt;/a&gt; state that a deposit paid before work starts "cannot exceed one-third of the total contract price or the actual cost of any material or equipment of a special order or custom made nature." The sample contract on the same page treats this as whichever is greater, so a large special order can justify a bigger deposit.&lt;/p&gt;

&lt;h3&gt;
  
  
  Florida
&lt;/h3&gt;

&lt;p&gt;Florida doesn't set a hard cap, but larger deposits come with obligations. Under Florida Statutes section 489.126, a contractor who receives more than 10% of the contract price for residential work must apply for necessary permits within 30 days of payment and start work within 90 days after permits are issued, unless there's just cause or the homeowner agreed in writing to a longer period.&lt;/p&gt;

&lt;h3&gt;
  
  
  Everywhere Else
&lt;/h3&gt;

&lt;p&gt;Other states have their own rules, and some have none specific to deposits. Check your state's contractor licensing board or attorney general's consumer protection office before you sign. Some cities and counties add their own requirements too.&lt;/p&gt;

&lt;h2&gt;
  
  
  Building a Fair Payment Schedule
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Tie Payments to Milestones You Can See
&lt;/h3&gt;

&lt;p&gt;The best payment schedules link each payment to completed work you can verify, such as "cabinets installed" rather than "week three." That way, the money you've paid never gets too far ahead of the work that's been done.&lt;/p&gt;

&lt;h3&gt;
  
  
  Hold Back a Final Payment
&lt;/h3&gt;

&lt;p&gt;Many contracts hold back a final payment, often around 5% to 10%, until the job is complete and any punch list items are fixed. This is sometimes called retainage or a holdback. It gives the contractor a reason to finish the small details promptly.&lt;/p&gt;

&lt;h3&gt;
  
  
  A Worked Example: A $40,000 Kitchen
&lt;/h3&gt;

&lt;p&gt;&lt;em&gt;This example is fictional, and its figures are illustrative.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;In a state without a specific deposit cap:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Deposit at signing (10%): $4,000&lt;/li&gt;
&lt;li&gt;Demolition and rough-in complete: $9,600&lt;/li&gt;
&lt;li&gt;Cabinets installed: $11,200&lt;/li&gt;
&lt;li&gt;Countertops set, plumbing and electrical finished: $11,200&lt;/li&gt;
&lt;li&gt;Final walkthrough and punch list (10%): $4,000&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;The same job in California:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Deposit at signing (capped): $1,000&lt;/li&gt;
&lt;li&gt;Demolition and rough-in complete: $10,500&lt;/li&gt;
&lt;li&gt;Cabinets installed: $12,250&lt;/li&gt;
&lt;li&gt;Countertops set, plumbing and electrical finished: $12,250&lt;/li&gt;
&lt;li&gt;Final walkthrough and punch list: $4,000&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;In California, each progress payment must also stay within the value of the work actually completed.&lt;/p&gt;

&lt;h3&gt;
  
  
  Change Orders
&lt;/h3&gt;

&lt;p&gt;Projects change. When they do, put every change in writing, with its price and its effect on the schedule, before the work happens. Add approved change orders to the next milestone payment rather than paying for them upfront in cash.&lt;/p&gt;

&lt;h2&gt;
  
  
  A Small Script to Draft a Milestone Schedule
&lt;/h2&gt;

&lt;p&gt;If you'd like to try different deposit amounts or milestones, this Node.js script drafts a schedule and applies the deposit rules for the four states above. It has no dependencies. Save it as &lt;code&gt;payment-schedule.mjs&lt;/code&gt; and edit the &lt;code&gt;job&lt;/code&gt; object:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// payment-schedule.mjs: draft a milestone payment schedule for a home project&lt;/span&gt;
&lt;span class="c1"&gt;// Usage: node payment-schedule.mjs [state]&lt;/span&gt;
&lt;span class="c1"&gt;// State rules below are simplified examples checked in November 2026.&lt;/span&gt;
&lt;span class="c1"&gt;// They are a starting point, not legal advice. Confirm current rules for your state.&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;job&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="na"&gt;total&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;40000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="na"&gt;depositPct&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;10&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;          &lt;span class="c1"&gt;// what the contractor asked for&lt;/span&gt;
  &lt;span class="na"&gt;specialOrderCost&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;     &lt;span class="c1"&gt;// custom materials ordered upfront (used for MA)&lt;/span&gt;
  &lt;span class="na"&gt;retainagePct&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;10&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;        &lt;span class="c1"&gt;// held back until the punch list is done&lt;/span&gt;
  &lt;span class="na"&gt;milestones&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;            &lt;span class="c1"&gt;// weights for the payments in between&lt;/span&gt;
    &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Demolition and rough-in complete&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;30&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
    &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Cabinets installed&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;35&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
    &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Countertops set, plumbing and electrical finished&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;35&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
  &lt;span class="p"&gt;],&lt;/span&gt;
&lt;span class="p"&gt;};&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="dl"&gt;''&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;toUpperCase&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;money&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;n&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="s2"&gt;`$&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;n&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toLocaleString&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;en-US&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;minimumFractionDigits&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;maximumFractionDigits&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt; &lt;span class="p"&gt;})}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;deposit&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;job&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;total&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;job&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;depositPct&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;100&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;notes&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[];&lt;/span&gt;

&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;CA&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;cap&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;min&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;job&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;total&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mf"&gt;0.1&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;deposit&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;cap&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;notes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`CA caps the down payment at &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nf"&gt;money&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;cap&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt; (lesser of $1,000 or 10%)`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nx"&gt;deposit&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;min&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;deposit&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;cap&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nx"&gt;notes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;CA: progress payments cannot exceed the value of work performed&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;MD&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;cap&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;job&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;total&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;deposit&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;cap&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;notes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`MD caps deposits at one-third: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nf"&gt;money&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;cap&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nx"&gt;deposit&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;min&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;deposit&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;cap&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;MA&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;cap&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;max&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;job&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;total&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;job&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;specialOrderCost&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;deposit&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;cap&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;notes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`MA caps deposits at one-third or special-order cost: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nf"&gt;money&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;cap&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nx"&gt;deposit&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;min&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;deposit&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;cap&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;FL&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;deposit&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;job&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;total&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mf"&gt;0.1&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;notes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;FL: over 10% upfront means permits within 30 days and work starting within 90 days of permits&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;retainage&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;job&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;total&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;job&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;retainagePct&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;100&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;middle&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;job&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;total&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="nx"&gt;deposit&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="nx"&gt;retainage&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;weightSum&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;job&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;milestones&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;reduce&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;s&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;[,&lt;/span&gt; &lt;span class="nx"&gt;w&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;s&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;w&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;rows&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
  &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Deposit at signing&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;deposit&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
  &lt;span class="p"&gt;...&lt;/span&gt;&lt;span class="nx"&gt;job&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;milestones&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;(([&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;w&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;middle&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;w&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="nx"&gt;weightSum&lt;/span&gt;&lt;span class="p"&gt;]),&lt;/span&gt;
  &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Final walkthrough and punch list&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;retainage&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
&lt;span class="p"&gt;];&lt;/span&gt;

&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;running&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`Payment schedule for &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nf"&gt;money&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;job&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;total&lt;/span&gt;&lt;span class="p"&gt;)}${&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="s2"&gt;` (&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;)`&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;''&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;amount&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;rows&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;running&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="nx"&gt;amount&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`  &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;padEnd&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;52&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt; &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nf"&gt;money&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;amount&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;padStart&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;11&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;  total &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nf"&gt;money&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;running&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="nx"&gt;notes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;forEach&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;n&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`  Note: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;n&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Running &lt;code&gt;node payment-schedule.mjs ca&lt;/code&gt; prints:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Payment schedule for $40,000.00 (CA)
  Deposit at signing                                     $1,000.00  total $1,000.00
  Demolition and rough-in complete                      $10,500.00  total $11,500.00
  Cabinets installed                                    $12,250.00  total $23,750.00
  Countertops set, plumbing and electrical finished     $12,250.00  total $36,000.00
  Final walkthrough and punch list                       $4,000.00  total $40,000.00
  Note: CA caps the down payment at $1,000.00 (lesser of $1,000 or 10%)
  Note: CA: progress payments cannot exceed the value of work performed
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Try &lt;code&gt;depositPct: 50&lt;/code&gt; with &lt;code&gt;md&lt;/code&gt;, and the script caps the deposit at $13,333.33, one-third of the contract. Use the output as a starting point for a conversation with your contractor, not as a substitute for reading your state's rules.&lt;/p&gt;

&lt;h2&gt;
  
  
  Protecting Your Deposit
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Get a written contract&lt;/strong&gt; that lists the deposit, every payment milestone, the scope of work, start and finish dates and the cancellation terms.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Pay by check or credit card,&lt;/strong&gt; never cash, and keep every receipt. Card payments may also give you dispute options if things go badly wrong.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Verify the contractor first.&lt;/strong&gt; Check their license with your state, confirm insurance and read reviews. Our guide to choosing a local plumber from online reviews walks through the same checks.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Ask about lien releases.&lt;/strong&gt; In many states, unpaid suppliers or subcontractors can file a lien on your property even if you've paid the contractor. Lien waivers or releases with each payment reduce that risk.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Confirm special orders.&lt;/strong&gt; If a large deposit covers custom materials, ask for the order confirmation or supplier invoice.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Red Flags
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Cash only,&lt;/strong&gt; or a discount for paying in cash&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Full payment upfront,&lt;/strong&gt; or a deposit well above your state's limit&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Pressure to pay today&lt;/strong&gt; to "hold the price" or "lock in the crew"&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;No written contract,&lt;/strong&gt; or a contract with blank spaces&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;No license number,&lt;/strong&gt; or a license that doesn't match the business name&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Vague reasons&lt;/strong&gt; for a large deposit, with no materials or permits to show for it&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  If the Contractor Takes the Deposit and Disappears
&lt;/h2&gt;

&lt;p&gt;Act quickly and keep records:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Document everything:&lt;/strong&gt; the contract, receipts, messages and dates.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Send a written demand&lt;/strong&gt; asking for the work to start or the deposit to be returned by a specific date.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;File a complaint&lt;/strong&gt; with your state's contractor licensing board and consumer protection office.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Consider small claims court&lt;/strong&gt; for smaller amounts.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Check for a recovery fund.&lt;/strong&gt; Some states, including Maryland through its Home Improvement Guaranty Fund, can compensate homeowners for losses caused by licensed contractors. Eligibility rules vary, and unlicensed contractors usually aren't covered.&lt;/li&gt;
&lt;/ol&gt;

&lt;h2&gt;
  
  
  Before You Pay: Check Reviews
&lt;/h2&gt;

&lt;p&gt;Before handing anyone a deposit, read what previous customers say about how the business handles money, schedules and problems. You can browse reviews of local businesses across &lt;a href="https://clutchpilot.com/categories" rel="noopener noreferrer"&gt;Clutchpilot business categories&lt;/a&gt;, and leave your own once your project is finished.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQs
&lt;/h2&gt;

&lt;h3&gt;
  
  
  How much of a deposit should a contractor ask for?
&lt;/h3&gt;

&lt;p&gt;Many home projects use a deposit of around 10% to 33% of the contract price, depending on the job, materials and state rules. Some states set limits, such as California's cap of $1,000 or 10%, whichever is less. The rest should be paid as work is completed.&lt;/p&gt;

&lt;h3&gt;
  
  
  Is it normal for a contractor to ask for 50% upfront?
&lt;/h3&gt;

&lt;p&gt;It's not typical for most remodels, and it may break deposit limits in some states. A larger deposit can make sense for expensive custom materials where your state allows it, but ask for proof of what the money covers, such as supplier invoices, and get everything in writing.&lt;/p&gt;

&lt;h3&gt;
  
  
  Is there a legal limit on contractor deposits?
&lt;/h3&gt;

&lt;p&gt;In some states, yes. California limits most home improvement down payments to $1,000 or 10%, whichever is less. Maryland caps deposits at one-third of the contract price, and Massachusetts at one-third or the cost of special-order materials. Check your own state's rules before signing.&lt;/p&gt;

&lt;h3&gt;
  
  
  What is a typical payment schedule for a remodel?
&lt;/h3&gt;

&lt;p&gt;A common structure is a modest deposit at signing, several progress payments tied to completed milestones such as demolition, rough-in and installation, and a final payment held until the walkthrough and punch list are complete. Each payment should match work you can see.&lt;/p&gt;

&lt;h3&gt;
  
  
  Should I pay a contractor in cash?
&lt;/h3&gt;

&lt;p&gt;It's best to avoid it. Cash leaves little record and no way to dispute a charge. Pay by check or credit card, keep receipts and be wary of contractors who insist on cash or offer a discount for it.&lt;/p&gt;

&lt;h3&gt;
  
  
  Can a contractor keep my deposit if I cancel?
&lt;/h3&gt;

&lt;p&gt;It depends on your contract, state law and how much work or ordering has already happened. Some sales may come with a short cancellation right, and custom materials may be non-refundable. Read the cancellation clause before signing, and ask how deposits are handled if plans change.&lt;/p&gt;

&lt;h3&gt;
  
  
  What should I do if a contractor took my deposit and didn't show up?
&lt;/h3&gt;

&lt;p&gt;Gather your contract, receipts and messages, then send a written demand for the work to start or the money to be returned. If that fails, file a complaint with your state's licensing board and consumer protection office, and consider small claims court or a state recovery fund if one applies.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrapping Up
&lt;/h2&gt;

&lt;p&gt;A normal contractor deposit amount covers real early costs without leaving you exposed. Check your state's limits, tie every later payment to completed work, hold back a final payment until the job's done and get it all in writing. When a deposit request feels too big, ask what it pays for. A good contractor will have a clear answer.&lt;/p&gt;

</description>
      <category>beginners</category>
      <category>javascript</category>
      <category>productivity</category>
      <category>discuss</category>
    </item>
    <item>
      <title>Choosing a Local Plumber From Online Reviews: A Worked Example</title>
      <dc:creator>Jay Barker</dc:creator>
      <pubDate>Wed, 11 Nov 2026 16:29:00 +0000</pubDate>
      <link>https://dev.to/jaybarker/choosing-a-local-plumber-from-online-reviews-a-worked-example-21j7</link>
      <guid>https://dev.to/jaybarker/choosing-a-local-plumber-from-online-reviews-a-worked-example-21j7</guid>
      <description>&lt;p&gt;It's Sunday evening, and there's water pooling under the kitchen sink. You turn off the valve, search for a plumber and get three results with nearly identical star ratings. One has a perfect 5.0. One has 4.5. One has 4.2. Which one do you call?&lt;/p&gt;

&lt;p&gt;Most people pick the highest number. That's often a mistake, because a star average hides almost everything that matters: how many reviews there are, when they were written, what they actually say and how the business handles problems.&lt;/p&gt;

&lt;p&gt;This post shows how to choose a local plumber by reading review patterns instead of averages. It walks through a worked example with three fictional plumbers, includes a small script that summarizes review patterns and ends with the checks to make before anyone touches your pipes.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Short Version
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Read patterns, not averages.&lt;/strong&gt; Look at how many reviews there are, how they're spread over time and how ratings are distributed.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Favor specific, recent reviews&lt;/strong&gt; that mention the job, the person and the price.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Watch how the owner responds&lt;/strong&gt; to complaints. It tells you how they'll treat you when something goes wrong.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Treat unusual patterns as questions,&lt;/strong&gt; not proof of fake reviews.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Verify before you book:&lt;/strong&gt; license, insurance, a written estimate and sensible payment terms.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Emergency vs Planned Work
&lt;/h2&gt;

&lt;p&gt;How much checking you can do depends on the situation.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;In an emergency,&lt;/strong&gt; such as a burst pipe or a leak you can't stop, shut off the water at the main valve first. That buys you time. Then do the quick checks in this post: a fast scan of review patterns, a call to confirm licensing and a clear price for the call-out before they arrive.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;For planned work,&lt;/strong&gt; such as a water heater replacement or a bathroom refit, take your time. Compare reviews properly, get several written estimates and check licenses and insurance before you choose.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Worked Example: Three Millbrook Plumbers
&lt;/h2&gt;

&lt;p&gt;&lt;em&gt;Millbrook and all three plumbers are fictional, and their review data is illustrative.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;A homeowner in Millbrook needs a leaking water heater valve fixed this week. Three local plumbers come up in search.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Plumber A: 5.0 from 38 reviews&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;29 of the 38 reviews arrived within the same two weeks&lt;/li&gt;
&lt;li&gt;Most reviews are four or five words long, such as "Great service!" or "Highly recommend"&lt;/li&gt;
&lt;li&gt;No reviews mention a job, a technician or a price&lt;/li&gt;
&lt;li&gt;The owner has never replied to a review&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Plumber B: 4.5 from 212 reviews&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Reviews are spread steadily over six years&lt;/li&gt;
&lt;li&gt;Most mention a specific job, often naming the technician&lt;/li&gt;
&lt;li&gt;A handful of 2-star and 1-star reviews complain about waiting for an appointment&lt;/li&gt;
&lt;li&gt;The owner has replied to every review of 3 stars or lower, and several complaints end with the problem fixed&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Plumber C: 4.2 from 64 reviews&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Several reviews mention the final bill being higher than the quote&lt;/li&gt;
&lt;li&gt;Some complaints have owner replies offering to make things right, others have none&lt;/li&gt;
&lt;li&gt;Positive reviews praise speed and friendliness&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;At first glance, Plumber A looks best. By the end of this post, it's clear why Plumber B is the safer call.&lt;/p&gt;

&lt;h2&gt;
  
  
  Reading Review Patterns, Not Star Averages
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Volume and Spread Over Time
&lt;/h3&gt;

&lt;p&gt;A large number of reviews collected steadily over years is hard to fake and gives you a reliable picture. A small number arriving all at once deserves a closer look.&lt;/p&gt;

&lt;p&gt;A burst of reviews isn't automatically suspicious. A business might have run a review request campaign, opened a new location or had a busy season. But when a burst coincides with short, generic text and no owner replies, as with Plumber A, it's a question worth asking.&lt;/p&gt;

&lt;h3&gt;
  
  
  Rating Distribution
&lt;/h3&gt;

&lt;p&gt;Real businesses get mixed reviews. Even excellent plumbers miss an appointment window or struggle with a tricky job sometimes. A natural profile usually has lots of 5-star reviews, a fair number of 4s and a few lower ratings.&lt;/p&gt;

&lt;p&gt;A profile that's almost entirely 5-star, especially with many reviews, isn't proof of anything, but it's less informative. Honest 3-star reviews are often the most useful ones to read, because they tend to describe both the good and the bad.&lt;/p&gt;

&lt;h3&gt;
  
  
  Specific vs Generic Text
&lt;/h3&gt;

&lt;p&gt;Useful reviews describe what happened: the problem, who came, how long it took, what it cost and whether the fix lasted. "Dana came out the same afternoon for a leaking water heater valve, explained the price before starting and cleaned up after" tells you far more than "Great service!"&lt;/p&gt;

&lt;p&gt;Specific reviews also help you match a plumber to your job. If you need a water heater replaced, look for reviews that mention water heaters.&lt;/p&gt;

&lt;h3&gt;
  
  
  Recency
&lt;/h3&gt;

&lt;p&gt;Businesses change. Owners sell, good technicians leave and new managers bring new habits. Give the last 12 months more weight than reviews from five years ago, and sort by newest to see the current picture.&lt;/p&gt;

&lt;h3&gt;
  
  
  How the Owner Responds
&lt;/h3&gt;

&lt;p&gt;Owner replies are one of the best signals you have. Look for calm, specific responses that acknowledge the problem and offer a fix. Defensive replies, blaming customers or no replies at all suggest how a complaint of your own might be handled.&lt;/p&gt;

&lt;p&gt;Plumber B's replies to low ratings, and the follow-up comments saying the issue was resolved, count for more than a slightly higher average elsewhere.&lt;/p&gt;

&lt;h3&gt;
  
  
  Cross-Check Across Platforms
&lt;/h3&gt;

&lt;p&gt;Check reviews in more than one place, such as Google, a review directory and your local community groups. A business with strong, consistent feedback across several sites is more trustworthy than one with a perfect score in only one place.&lt;/p&gt;

&lt;h2&gt;
  
  
  What Fake Reviews Look Like, and the Rules Against Them
&lt;/h2&gt;

&lt;p&gt;Fake reviews are illegal in the US. The &lt;a href="https://www.ftc.gov/news-events/news/press-releases/2024/08/federal-trade-commission-announces-final-rule-banning-fake-reviews-testimonials" rel="noopener noreferrer"&gt;FTC's final rule banning fake reviews&lt;/a&gt;, which took effect on October 21, 2024, prohibits reviews "by someone who does not exist, such as AI-generated fake reviews." It also bans undisclosed reviews from company insiders and the use of "unfounded or groundless legal threats" to suppress negative reviews.&lt;/p&gt;

&lt;p&gt;Platforms have their own rules too. &lt;a href="https://support.google.com/contributionpolicy/answer/7400114" rel="noopener noreferrer"&gt;Google Maps' policy on fake engagement&lt;/a&gt; states that "Contributions to Google Maps should reflect a genuine experience at a place or business," and that "Fake engagement is not allowed and will be removed."&lt;/p&gt;

&lt;p&gt;Common warning signs include:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Bursts of short, generic praise&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Several reviews with very similar wording&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Reviewer profiles with only one review,&lt;/strong&gt; or reviews of businesses all over the country&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Reviews that describe services the business doesn't offer&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A perfect score with no detail at all&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;None of these proves a review is fake. Together, they're a reason to rely on other evidence.&lt;/p&gt;

&lt;h2&gt;
  
  
  A Small Script to Spot Review Patterns
&lt;/h2&gt;

&lt;p&gt;If you're comparing several businesses, or you just like seeing the numbers, a short script can summarize a review set in seconds. Paste or export reviews into a JSON file, one object per review, then run this Node.js script. It has no dependencies:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// review-patterns.mjs: summarize review patterns for one business&lt;/span&gt;
&lt;span class="c1"&gt;// Usage: node review-patterns.mjs reviews.json&lt;/span&gt;
&lt;span class="c1"&gt;// reviews.json: [{ "date": "2026-03-14", "rating": 5, "text": "...", "ownerReplied": true }]&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;readFileSync&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;node:fs&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;reviews&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;parse&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;readFileSync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;utf8&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
  &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="p"&gt;...&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;time&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Date&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;date&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;getTime&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;}))&lt;/span&gt;
  &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;sort&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;a&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;b&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;a&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;time&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="nx"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;time&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;n&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;reviews&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;DAY&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;86&lt;/span&gt;&lt;span class="nx"&gt;_400_000&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;pct&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;x&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;round&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;x&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="nx"&gt;n&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mi"&gt;100&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;%`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="c1"&gt;// Rating spread&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;spread&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;5&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;s&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;s&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;★ &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;reviews&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;rating&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nx"&gt;s&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;avg&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;reviews&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;reduce&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;sum&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;sum&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;rating&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="nx"&gt;n&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="c1"&gt;// Busiest 14-day window&lt;/span&gt;
&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;maxWindow&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;j&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="nx"&gt;n&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;while &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;reviews&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="nx"&gt;time&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="nx"&gt;reviews&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;j&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="nx"&gt;time&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;14&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;DAY&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;j&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nx"&gt;maxWindow&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;max&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;maxWindow&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="nx"&gt;j&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="c1"&gt;// Text detail and owner replies&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;words&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;reviews&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;text&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;trim&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;split&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;/&lt;/span&gt;&lt;span class="se"&gt;\s&lt;/span&gt;&lt;span class="sr"&gt;+/&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;Boolean&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;avgWords&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;words&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;reduce&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;a&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;b&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;a&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;b&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="nx"&gt;n&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;replied&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;reviews&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;ownerReplied&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;repliedToLow&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;reviews&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;rating&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;=&lt;/span&gt; &lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;months&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;reviews&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;n&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="nx"&gt;time&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="nx"&gt;reviews&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="nx"&gt;time&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;30&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;DAY&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`Reviews: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;n&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; over &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;months&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toFixed&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt; months, average &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;avg&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toFixed&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`Spread: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;spread&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt; | &lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`Busiest 14 days: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;maxWindow&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; reviews (&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nf"&gt;pct&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;maxWindow&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;)`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`Average length: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;avgWords&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toFixed&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt; words`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`Owner replied: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nf"&gt;pct&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;replied&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt; overall, &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;repliedToLow&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;ownerReplied&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;/&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;repliedToLow&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; of 3★ or lower`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

&lt;span class="c1"&gt;// Signals worth a closer look (not proof of anything)&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;signals&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[];&lt;/span&gt;
&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;maxWindow&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="nx"&gt;n&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mf"&gt;0.4&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;signals&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Over 40% of reviews arrived within 14 days&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;n&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;=&lt;/span&gt; &lt;span class="mi"&gt;20&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;reviews&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;rating&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;5&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="nx"&gt;n&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mf"&gt;0.9&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;signals&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Over 90% are 5-star&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;avgWords&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="mi"&gt;12&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;signals&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Reviews are very short on average&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;replied&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="nx"&gt;n&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="mf"&gt;0.2&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;signals&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Owner rarely replies&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;signals&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="s2"&gt;`Look closer: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;signals&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;; &lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;No unusual patterns flagged&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Here's the output for the fictional Plumber A:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Reviews: 38 over 20 months, average 5.0
Spread: 5★ 37 | 4★ 1 | 3★ 0 | 2★ 0 | 1★ 0
Busiest 14 days: 29 reviews (76%)
Average length: 4 words
Owner replied: 0% overall, 0/0 of 3★ or lower
Look closer: Over 40% of reviews arrived within 14 days; Over 90% are 5-star; Reviews are very short on average; Owner rarely replies
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;And for Plumber B:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Reviews: 212 over 72 months, average 4.5
Spread: 5★ 144 | 4★ 48 | 3★ 11 | 2★ 5 | 1★ 4
Busiest 14 days: 2 reviews (1%)
Average length: 20 words
Owner replied: 49% overall, 20/20 of 3★ or lower
No unusual patterns flagged
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The thresholds are deliberately simple, so adjust them to taste. And remember what the output is: signals that tell you where to look, not a verdict on whether a business is honest. Only collect reviews you can view publicly, and respect each platform's terms of service.&lt;/p&gt;

&lt;h2&gt;
  
  
  Verify Before You Book
&lt;/h2&gt;

&lt;p&gt;Reviews narrow the list. These checks make the decision.&lt;/p&gt;

&lt;h3&gt;
  
  
  License
&lt;/h3&gt;

&lt;p&gt;Licensing rules for plumbers vary by state and sometimes by city or county. &lt;a href="https://consumer.ftc.gov/articles/how-avoid-home-improvement-scam" rel="noopener noreferrer"&gt;The FTC's guide to avoiding home improvement scams&lt;/a&gt; advises: "Check with your state or county government to confirm a contractor's license." Most states offer an online license lookup through their licensing board.&lt;/p&gt;

&lt;h3&gt;
  
  
  Insurance
&lt;/h3&gt;

&lt;p&gt;Ask for proof of liability insurance, and workers' compensation if the business has employees. If something goes wrong in your home, insurance protects you from paying for damage or injuries.&lt;/p&gt;

&lt;h3&gt;
  
  
  Written Estimate
&lt;/h3&gt;

&lt;p&gt;For anything beyond a small repair, get the price in writing. The FTC says to "Get multiple estimates" and "Don't automatically choose the lowest bidder." A good estimate lists the work, parts, labor, any permit costs, the expected timeline and the warranty.&lt;/p&gt;

&lt;h3&gt;
  
  
  Payment Terms
&lt;/h3&gt;

&lt;p&gt;Be cautious about large upfront payments. The FTC advises: "Don't pay the full amount for the project up front," and notes that some states limit down payments. For emergency call-outs, confirm the call-out fee and hourly rate before the plumber arrives.&lt;/p&gt;

&lt;p&gt;In the Millbrook example, Plumber B passed every check: a valid state license, proof of insurance and a written quote for the valve repair that matched the final bill.&lt;/p&gt;

&lt;h2&gt;
  
  
  Questions to Ask on the Phone
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Do you charge a flat rate for this job or by the hour?&lt;/li&gt;
&lt;li&gt;Is there a call-out or diagnostic fee, and is it credited toward the repair?&lt;/li&gt;
&lt;li&gt;Who will actually come out, and are they licensed?&lt;/li&gt;
&lt;li&gt;Will this job need a permit, and who arranges it?&lt;/li&gt;
&lt;li&gt;What warranty do you give on parts and labor?&lt;/li&gt;
&lt;li&gt;How soon can you come, and what's the arrival window?&lt;/li&gt;
&lt;li&gt;Do you clean up after the job?&lt;/li&gt;
&lt;li&gt;Which payment methods do you accept, and when is payment due?&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Red Flags
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Cash only,&lt;/strong&gt; or pressure to pay everything up front. The FTC warns that "Scammers ask you to pay for everything up front or only accept cash."&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Door-to-door offers&lt;/strong&gt; from someone who says they're "in the area"&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Pressure to decide immediately&lt;/strong&gt; on large, non-emergency work&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;No written estimate,&lt;/strong&gt; or an estimate with blank spaces&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;No verifiable business address&lt;/strong&gt; or license number&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A burst of vague, perfect reviews&lt;/strong&gt; and nothing else to go on&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  After the Job: Leave a Useful Review
&lt;/h2&gt;

&lt;p&gt;Once the work is done, pay it forward. A useful review mentions the problem, who came, how long it took, what it cost compared with the quote and whether the fix has held. That's exactly the kind of detail you were looking for when you started.&lt;/p&gt;

&lt;p&gt;You can share your experience, and read other customers' reviews of local businesses, on &lt;a href="https://clutchpilot.com/businesses" rel="noopener noreferrer"&gt;Clutchpilot's business reviews directory&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQs
&lt;/h2&gt;

&lt;h3&gt;
  
  
  How do I find a good local plumber?
&lt;/h3&gt;

&lt;p&gt;Start with plumbers who have plenty of recent, specific reviews spread over time and owners who respond well to complaints. Cross-check across more than one site, then confirm the plumber's license with your state or county, ask for proof of insurance and get a written estimate before work begins.&lt;/p&gt;

&lt;h3&gt;
  
  
  What should I ask a plumber before hiring?
&lt;/h3&gt;

&lt;p&gt;Ask whether they charge a flat rate or by the hour, whether there's a call-out fee, who will do the work, whether a permit is needed, what warranty covers parts and labor, how soon they can come and how payment works. Get the key answers in writing.&lt;/p&gt;

&lt;h3&gt;
  
  
  How can I tell if plumber reviews are fake?
&lt;/h3&gt;

&lt;p&gt;Look for warning signs such as a sudden burst of short, generic five-star reviews, similar wording across several reviews, reviewers with only one review and no owner replies. These patterns don't prove reviews are fake, but they're a reason to rely more on other evidence.&lt;/p&gt;

&lt;h3&gt;
  
  
  Should a plumber be licensed and insured?
&lt;/h3&gt;

&lt;p&gt;In many places, plumbers must be licensed, though rules vary by state and locality. Check with your state or county licensing authority, and ask for proof of liability insurance. Hiring licensed, insured professionals protects you if something goes wrong.&lt;/p&gt;

&lt;h3&gt;
  
  
  Is it better to pay a plumber hourly or a flat rate?
&lt;/h3&gt;

&lt;p&gt;Flat rates make costs predictable for common jobs, such as replacing a faucet. Hourly rates can suit diagnostic work where the problem isn't clear yet. Either way, ask for an estimate upfront, confirm any call-out fee and get the final price in writing.&lt;/p&gt;

&lt;h3&gt;
  
  
  How many quotes should I get for plumbing work?
&lt;/h3&gt;

&lt;p&gt;For planned work, get at least two or three written estimates. The FTC advises getting multiple estimates and not automatically choosing the lowest bidder. For emergencies, one trustworthy plumber with a clear call-out fee is often the practical choice.&lt;/p&gt;

&lt;h3&gt;
  
  
  What are red flags when hiring a plumber?
&lt;/h3&gt;

&lt;p&gt;Be wary of cash-only payment, pressure to pay everything up front, door-to-door offers, pressure to decide immediately, no written estimate and no verifiable license or address. A burst of vague, perfect reviews with nothing else to support them is another reason for caution.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrapping Up
&lt;/h2&gt;

&lt;p&gt;Choosing a local plumber from online reviews works best when you treat reviews as evidence. Look at volume, timing, rating spread, detail and owner responses, rather than the star average alone. Then confirm the license, insurance and written estimate before booking. And when the job's done, leave the kind of review you'd want to read.&lt;/p&gt;

</description>
      <category>beginners</category>
      <category>javascript</category>
      <category>productivity</category>
      <category>discuss</category>
    </item>
    <item>
      <title>Logo File Formats for Print and Web: What to Ask For</title>
      <dc:creator>Jay Barker</dc:creator>
      <pubDate>Tue, 10 Nov 2026 16:25:00 +0000</pubDate>
      <link>https://dev.to/jaybarker/logo-file-formats-for-print-and-web-what-to-ask-for-4g5a</link>
      <guid>https://dev.to/jaybarker/logo-file-formats-for-print-and-web-what-to-ask-for-4g5a</guid>
      <description>&lt;p&gt;A new client sends the brief, and you ask for their logo. What comes back is a 200-pixel JPG with a white box around it, saved from their own website. It looks fine in the email. It looks terrible on a dark header, worse on a retina screen and completely unusable on a trade show banner.&lt;/p&gt;

&lt;p&gt;Most logo problems aren't design problems. They're file problems. Somebody never asked for the right files, so nobody has them.&lt;/p&gt;

&lt;p&gt;This guide covers the logo file formats worth asking for, what vector vs PNG actually means, what printers want, which color versions you need and how to use a logo properly in code, including optimizing SVGs and keeping them safe.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Short Answer: The Logo Package to Ask For
&lt;/h2&gt;

&lt;p&gt;When a logo is finished, ask the designer for:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;A vector master file,&lt;/strong&gt; usually AI (Adobe Illustrator) or SVG, so the logo can be edited and scaled&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A print-ready vector file,&lt;/strong&gt; usually PDF or EPS, for printers and vendors&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;SVG files&lt;/strong&gt; for websites and apps&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Transparent PNGs&lt;/strong&gt; in a few sizes for documents, slides and social media&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A JPG&lt;/strong&gt; for the occasional platform that won't accept anything else&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Color versions:&lt;/strong&gt; full color, one-color black, one-color white and ideally grayscale&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Layouts:&lt;/strong&gt; horizontal, stacked and the icon or mark on its own&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Color codes&lt;/strong&gt; in HEX, RGB, CMYK and, if used, Pantone&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A short usage guide&lt;/strong&gt; covering spacing, minimum size and what not to do&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;If you only remember one thing, remember this: &lt;strong&gt;always get the vector source.&lt;/strong&gt; Everything else can be exported from it. Nothing good can be made from a small JPG.&lt;/p&gt;

&lt;h2&gt;
  
  
  Vector vs PNG: The One Distinction That Matters
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Vector Files
&lt;/h3&gt;

&lt;p&gt;Vector graphics describe shapes with math: points, lines, curves and fills. Because they're instructions rather than pixels, they scale to any size without losing quality. A vector logo looks just as sharp on a business card as on a billboard.&lt;/p&gt;

&lt;p&gt;SVG is the vector format of the web. &lt;a href="https://developer.mozilla.org/en-US/docs/Web/SVG" rel="noopener noreferrer"&gt;MDN's SVG documentation&lt;/a&gt; defines it as "an XML-based markup language for describing two-dimensional based vector graphics." That XML part matters later, when we get to optimization and security.&lt;/p&gt;

&lt;h3&gt;
  
  
  Raster Files
&lt;/h3&gt;

&lt;p&gt;Raster images, such as PNG, JPG and WebP, are grids of pixels. Each file has a fixed resolution. Enlarge it beyond that, and edges go soft or blocky, because the software has to invent pixels that don't exist.&lt;/p&gt;

&lt;h3&gt;
  
  
  Why You Need Both
&lt;/h3&gt;

&lt;p&gt;Vector is the master. Raster is for everyday use in places that don't support vectors well, such as some email clients, document editors and social platforms. The right approach is to keep the vector files safe and export raster versions from them as needed, at the sizes you actually use.&lt;/p&gt;

&lt;h2&gt;
  
  
  Each Logo File Format and When to Use It
&lt;/h2&gt;

&lt;h3&gt;
  
  
  AI (Adobe Illustrator)
&lt;/h3&gt;

&lt;p&gt;The working file most designers create logos in. It's fully editable, with layers, artboards and color settings. You need Illustrator, or a compatible tool, to open it properly. Ask for it even if you'll never open it yourself, so a future designer can make changes.&lt;/p&gt;

&lt;h3&gt;
  
  
  SVG
&lt;/h3&gt;

&lt;p&gt;The best format for websites and apps. SVGs are vector, usually tiny in file size, support transparency and can be styled with CSS. They're also plain text, so you can open one in a code editor and see exactly what's inside.&lt;/p&gt;

&lt;h3&gt;
  
  
  EPS
&lt;/h3&gt;

&lt;p&gt;An older vector format still widely requested by printers, sign makers and promotional product companies. Many design tools now favor PDF for print, but having an EPS on hand saves time when a vendor insists on it.&lt;/p&gt;

&lt;h3&gt;
  
  
  PDF
&lt;/h3&gt;

&lt;p&gt;A flexible format that can contain vector artwork, which makes it excellent for print and easy to share, because almost anyone can open it. A vector PDF from Illustrator is often what a printer prefers. A PDF that simply wraps a raster image is not a true vector file, so check what's inside.&lt;/p&gt;

&lt;h3&gt;
  
  
  PNG
&lt;/h3&gt;

&lt;p&gt;The go-to raster format for logos, because it supports transparent backgrounds. Use PNGs in documents, presentations, social media profiles and anywhere SVG isn't supported. Export them at the sizes you need, including 2x versions for high-density screens.&lt;/p&gt;

&lt;h3&gt;
  
  
  JPG
&lt;/h3&gt;

&lt;p&gt;JPG doesn't support transparency, so a JPG logo always sits in a rectangle, usually white. JPG compression can also blur the sharp edges logos depend on. Use it only when a platform requires it.&lt;/p&gt;

&lt;h3&gt;
  
  
  WebP and AVIF
&lt;/h3&gt;

&lt;p&gt;Modern raster formats that are often smaller than PNG and support transparency. They're great for delivering images on a website, but they're not master files. If you serve them, keep a fallback for older browsers. Our earlier post on WebP fallback images covers how.&lt;/p&gt;

&lt;h2&gt;
  
  
  Color Versions and Color Modes to Ask For
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Color Versions
&lt;/h3&gt;

&lt;p&gt;A single full-color logo won't work everywhere. Ask for:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Full color,&lt;/strong&gt; your primary version&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;One-color black,&lt;/strong&gt; for faxes, stamps, newspapers and single-color printing&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;One-color white,&lt;/strong&gt; also called reversed, for dark backgrounds and photos&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Grayscale,&lt;/strong&gt; if the logo relies on shading&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Color Modes
&lt;/h3&gt;

&lt;p&gt;Screens and printers create color differently, which is why your logo needs color values for both:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;RGB and HEX&lt;/strong&gt; describe color for screens. HEX is the six-character code used in CSS, such as &lt;code&gt;#1f6f5c&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;CMYK&lt;/strong&gt; describes color for most printing, using cyan, magenta, yellow and black inks. &lt;a href="https://helpx.adobe.com/photoshop/using/color-modes.html" rel="noopener noreferrer"&gt;Adobe's guide to color modes&lt;/a&gt; explains which modes suit print, web and specialized workflows.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Pantone&lt;/strong&gt; or other spot colors are premixed inks used when a color must match exactly every time, such as on packaging or branded merchandise.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Bright on-screen colors don't always have an exact CMYK equivalent, so a vivid RGB green may print duller. Your designer should choose matching values for each mode rather than letting software convert them automatically.&lt;/p&gt;

&lt;h3&gt;
  
  
  Layouts
&lt;/h3&gt;

&lt;p&gt;Logos are used in very different spaces, so ask for a &lt;strong&gt;horizontal&lt;/strong&gt; layout for website headers and email signatures, a &lt;strong&gt;stacked&lt;/strong&gt; layout for square spaces and the &lt;strong&gt;icon or mark&lt;/strong&gt; on its own for favicons, app icons and social avatars.&lt;/p&gt;

&lt;h2&gt;
  
  
  Print: What Printers and Vendors Actually Want
&lt;/h2&gt;

&lt;p&gt;Printers generally want:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Vector artwork,&lt;/strong&gt; usually a PDF or EPS&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;CMYK or spot color values,&lt;/strong&gt; not just RGB&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Fonts converted to outlines,&lt;/strong&gt; so the printer doesn't need your typeface installed&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A high-resolution raster fallback,&lt;/strong&gt; typically 300 pixels per inch at the final print size, if vector isn't possible&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Some uses have extra needs. Embroidery often requires a simplified version with fewer fine details. Screen printing may need a one-color or limited-color version. Large signs and vehicle wraps almost always need true vector files. When in doubt, ask the vendor for their file requirements before you send anything.&lt;/p&gt;

&lt;h2&gt;
  
  
  Web: Using Your Logo in Code
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Optimize the SVG
&lt;/h3&gt;

&lt;p&gt;SVGs exported from design tools often include editor metadata, comments and unnecessarily precise numbers. SVGO, a popular Node.js tool, strips that out:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx svgo logo.svg &lt;span class="nt"&gt;-o&lt;/span&gt; logo.min.svg
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;On a sample logo exported with Illustrator-style metadata, SVGO 4.1 reduced the file from 735 bytes to 226 bytes, a 69% saving, without changing how it looks.&lt;/p&gt;

&lt;p&gt;One catch: in the same test, SVGO's default settings removed a &lt;code&gt;role="img"&lt;/code&gt; attribute and an &lt;code&gt;id&lt;/code&gt; that an &lt;code&gt;aria-labelledby&lt;/code&gt; attribute referenced, which breaks the accessible name. Optimize first, then add accessibility attributes, or configure SVGO to keep them.&lt;/p&gt;

&lt;h3&gt;
  
  
  Use Accessible Markup
&lt;/h3&gt;

&lt;p&gt;For most logos, a plain image tag is the simplest and most robust choice:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;a&lt;/span&gt; &lt;span class="na"&gt;href=&lt;/span&gt;&lt;span class="s"&gt;"/"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;img&lt;/span&gt; &lt;span class="na"&gt;src=&lt;/span&gt;&lt;span class="s"&gt;"/logo.min.svg"&lt;/span&gt; &lt;span class="na"&gt;alt=&lt;/span&gt;&lt;span class="s"&gt;"Acme Studio home"&lt;/span&gt; &lt;span class="na"&gt;width=&lt;/span&gt;&lt;span class="s"&gt;"240"&lt;/span&gt; &lt;span class="na"&gt;height=&lt;/span&gt;&lt;span class="s"&gt;"80"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;/a&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;If you inline the SVG, for example to change its color with CSS, give it a role and an accessible name:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;svg&lt;/span&gt; &lt;span class="na"&gt;role=&lt;/span&gt;&lt;span class="s"&gt;"img"&lt;/span&gt; &lt;span class="na"&gt;aria-labelledby=&lt;/span&gt;&lt;span class="s"&gt;"logo-title"&lt;/span&gt; &lt;span class="na"&gt;viewBox=&lt;/span&gt;&lt;span class="s"&gt;"0 0 240 80"&lt;/span&gt; &lt;span class="na"&gt;width=&lt;/span&gt;&lt;span class="s"&gt;"240"&lt;/span&gt; &lt;span class="na"&gt;height=&lt;/span&gt;&lt;span class="s"&gt;"80"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;title&lt;/span&gt; &lt;span class="na"&gt;id=&lt;/span&gt;&lt;span class="s"&gt;"logo-title"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;Acme Studio&lt;span class="nt"&gt;&amp;lt;/title&amp;gt;&lt;/span&gt;
  &lt;span class="c"&gt;&amp;lt;!-- logo paths --&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;/svg&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Size It Properly
&lt;/h3&gt;

&lt;p&gt;Always set &lt;code&gt;width&lt;/code&gt; and &lt;code&gt;height&lt;/code&gt;, or use CSS &lt;code&gt;aspect-ratio&lt;/code&gt;, so the browser reserves space and the page doesn't jump while loading. That helps your Cumulative Layout Shift (CLS) score.&lt;/p&gt;

&lt;p&gt;If you need PNG versions, export them from the vector file rather than resizing an old PNG. This short script uses the sharp library to export transparent PNGs at a few widths:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// export-png.mjs: export transparent PNGs from an SVG logo at set widths&lt;/span&gt;
&lt;span class="c1"&gt;// Usage: node export-png.mjs logo.svg&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nx"&gt;sharp&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;sharp&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;input&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;logo.svg&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;widths&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;240&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;480&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1200&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt; &lt;span class="c1"&gt;// 1x header, 2x retina, large&lt;/span&gt;

&lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;width&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;widths&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;input&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;density&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;600&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt; &lt;span class="c1"&gt;// rasterize at high density, then resize down&lt;/span&gt;
    &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;resize&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="nx"&gt;width&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
    &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;png&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
    &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`logo-&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;width&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;w.png`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`logo-&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;width&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;w.png`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Run with &lt;code&gt;node export-png.mjs logo.min.svg&lt;/code&gt;, it produced 240×80, 480×160 and 1200×400 PNGs with transparent backgrounds intact.&lt;/p&gt;

&lt;h3&gt;
  
  
  Be Careful With SVG Uploads
&lt;/h3&gt;

&lt;p&gt;Because SVG is XML, an SVG file can contain more than shapes, including scripts and links to external resources. Your own logo files are fine. The risk comes when a site lets users upload SVGs, such as profile images or a CMS media library open to many contributors.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://cheatsheetseries.owasp.org/cheatsheets/File_Upload_Cheat_Sheet.html" rel="noopener noreferrer"&gt;OWASP's file upload cheat sheet&lt;/a&gt; warns that uploaded files can carry "Client-side active content (XSS, CSRF, etc.) that could endanger other users if the files are publicly retrievable," and lists XML bombs among malicious file types. If your site accepts SVG uploads, sanitize them with a maintained library, serve them from a separate domain or don't accept SVG from untrusted users at all.&lt;/p&gt;

&lt;h3&gt;
  
  
  Favicons and Social Share Images
&lt;/h3&gt;

&lt;p&gt;Your logo mark usually becomes your favicon and app icon. Our earlier guide to favicon basics covers sizes and formats. For social shares, create a dedicated 1200×630 Open Graph image that places the logo on a background, rather than using the logo file directly, which often gets cropped awkwardly.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Handoff Checklist: What to Ask Your Designer For
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;[ ] Editable vector master (AI or SVG)&lt;/li&gt;
&lt;li&gt;[ ] Print-ready vector (PDF and EPS)&lt;/li&gt;
&lt;li&gt;[ ] Optimized SVG for web&lt;/li&gt;
&lt;li&gt;[ ] Transparent PNGs at standard sizes, including 2x&lt;/li&gt;
&lt;li&gt;[ ] JPG versions for platforms that require them&lt;/li&gt;
&lt;li&gt;[ ] Full color, black, white and grayscale versions&lt;/li&gt;
&lt;li&gt;[ ] Horizontal, stacked and icon-only layouts&lt;/li&gt;
&lt;li&gt;[ ] HEX, RGB, CMYK and Pantone values&lt;/li&gt;
&lt;li&gt;[ ] Font names, and confirmation that their licenses cover your use&lt;/li&gt;
&lt;li&gt;[ ] A usage guide with clear space, minimum size and examples of misuse&lt;/li&gt;
&lt;li&gt;[ ] Clear, consistent file names, such as &lt;code&gt;acme-logo-horizontal-white.svg&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;[ ] Written confirmation that copyright in the final logo transfers to you on payment&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That last point matters more than most people realize. Without written terms, ownership of the design isn't automatic.&lt;/p&gt;

&lt;h2&gt;
  
  
  Common Mistakes
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Using a JPG with a white box&lt;/strong&gt; on a colored background&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Stretching or squashing&lt;/strong&gt; the logo instead of scaling it proportionally&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A "vector" file that isn't vector.&lt;/strong&gt; Some SVG, EPS and PDF files simply wrap a raster image. Open an SVG in a text editor, and if you see an &lt;code&gt;&amp;lt;image&amp;gt;&lt;/code&gt; tag with embedded data instead of paths, it's not a true vector logo.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;No white version,&lt;/strong&gt; leading to awkward boxes on dark backgrounds&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;No editable source,&lt;/strong&gt; so every small change means starting from scratch&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Low-resolution files sent to print&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Getting a Logo Package Made
&lt;/h2&gt;

&lt;p&gt;If you're starting from scratch or your current logo only exists as a small image, a professional designer can create a proper package. Nexi Bloom's &lt;a href="https://nexibloom.com/services/logo-design" rel="noopener noreferrer"&gt;custom logo design packages&lt;/a&gt; include vector files in AI, EPS and SVG, high-resolution and transparent-background files, and a brand color palette guide. As with any designer, confirm the full list of files, color versions and ownership terms in writing before you start.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQs
&lt;/h2&gt;

&lt;h3&gt;
  
  
  What file format should a logo be in?
&lt;/h3&gt;

&lt;p&gt;A logo should be created as a vector file, usually AI or SVG, so it can be edited and scaled without losing quality. From that master, export SVG for websites, PDF or EPS for print and transparent PNGs for documents, slides and social media.&lt;/p&gt;

&lt;h3&gt;
  
  
  What is the best logo format for printing?
&lt;/h3&gt;

&lt;p&gt;A vector PDF or EPS is usually best for printing, with CMYK or spot color values and fonts converted to outlines. If a printer can only accept raster files, provide a high-resolution PNG or TIFF at around 300 pixels per inch at the final print size.&lt;/p&gt;

&lt;h3&gt;
  
  
  What's the difference between an SVG and a PNG logo?
&lt;/h3&gt;

&lt;p&gt;An SVG is a vector file that scales to any size without losing quality and is usually very small. A PNG is a raster file made of pixels, with a fixed resolution and transparency support. Use SVG on websites where possible and PNG where vectors aren't supported.&lt;/p&gt;

&lt;h3&gt;
  
  
  Is EPS still needed for logos?
&lt;/h3&gt;

&lt;p&gt;Often, yes. Many printers, sign makers and promotional product suppliers still request EPS files, even though PDF has largely replaced it in modern design workflows. It's worth having an EPS version in your logo package so you're never stuck when a vendor asks for one.&lt;/p&gt;

&lt;h3&gt;
  
  
  How do I know if my logo is a vector file?
&lt;/h3&gt;

&lt;p&gt;Zoom in a long way. A vector logo stays sharp at any zoom level, while a raster logo becomes blurry or pixelated. You can also open an SVG in a text editor: true vector files contain paths and shapes, not an embedded image.&lt;/p&gt;

&lt;h3&gt;
  
  
  What logo files should I get from my designer?
&lt;/h3&gt;

&lt;p&gt;Ask for an editable vector master, print-ready PDF and EPS files, an optimized SVG, transparent PNGs in several sizes, full color, black, white and grayscale versions, horizontal and stacked layouts, color codes, font details, a usage guide and written confirmation that you own the copyright.&lt;/p&gt;

&lt;h3&gt;
  
  
  Can I convert a PNG logo to a vector?
&lt;/h3&gt;

&lt;p&gt;Yes, but automatic tools such as image trace often produce rough edges and messy paths, especially from small or low-quality images. For a logo you'll use for years, have a designer redraw it as a clean vector, then export every other format from that.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrapping Up
&lt;/h2&gt;

&lt;p&gt;The right logo files make every future job easier, from your website header to a printed banner. Ask for a vector master, print-ready files, web-ready SVGs and transparent PNGs, plus color versions, layouts and written ownership. Then optimize your SVGs, keep markup accessible and treat untrusted SVG uploads with care.&lt;/p&gt;

</description>
      <category>design</category>
      <category>webdev</category>
      <category>beginners</category>
      <category>svg</category>
    </item>
    <item>
      <title>Hosting Renewal Price Jumps: How to Compare the Real Yearly Cost</title>
      <dc:creator>Jay Barker</dc:creator>
      <pubDate>Mon, 09 Nov 2026 15:16:00 +0000</pubDate>
      <link>https://dev.to/jaybarker/hosting-renewal-price-jumps-how-to-compare-the-real-yearly-cost-11c5</link>
      <guid>https://dev.to/jaybarker/hosting-renewal-price-jumps-how-to-compare-the-real-yearly-cost-11c5</guid>
      <description>&lt;p&gt;The email arrives a year after you signed up. Your hosting plan, the one you bought for $2.99 a month, is about to renew. The new price is several times higher, and because the promo was billed upfront, the renewal will be too.&lt;/p&gt;

&lt;p&gt;Nothing illegal happened. The renewal price was probably on the checkout page all along, in small gray text below the big orange number. But it's still one of the most common surprises in web hosting, and it makes comparing hosts much harder than it should be.&lt;/p&gt;

&lt;p&gt;This post explains why hosting renewal prices jump, where to find the real number, which add-ons quietly raise your yearly bill and how to calculate the true yearly cost of any plan. There's also a small script you can use to compare two plans side by side.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why Hosting Renewal Prices Jump
&lt;/h2&gt;

&lt;p&gt;Introductory prices are a customer acquisition tool. Hosts know that most people don't switch providers once a site is running, because moving a website, its email and its DNS feels like a chore. So many hosts price the first term low, sometimes below cost, and recover the difference at renewal.&lt;/p&gt;

&lt;p&gt;A few common patterns make the jump bigger than it looks:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;The low price requires a long term.&lt;/strong&gt; The advertised monthly rate often applies only if you prepay 12, 24, 36 or even 48 months.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The whole term is billed upfront.&lt;/strong&gt; "$2.99 a month" might really be one charge of $107.64 for 36 months.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The renewal follows the same structure.&lt;/strong&gt; When the term ends, you're often billed for another full term at the regular rate.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Free extras expire.&lt;/strong&gt; A free domain or SSL add-on for the first year renews at full price.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;None of this is unusual or hidden in a legal sense. It's just designed so the number you remember isn't the number you'll keep paying.&lt;/p&gt;

&lt;h2&gt;
  
  
  Intro vs Renewal Pricing: Where to Find the Real Number
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Look Beyond the Headline Price
&lt;/h3&gt;

&lt;p&gt;The renewal price is usually somewhere on the pricing page or at checkout, often in a footnote or smaller text next to the plan. Many hosts also publish a renewal pricing FAQ or a full renewal price list in their help center. If you can't find either, check the terms of service, or ask support in writing before you buy.&lt;/p&gt;

&lt;h3&gt;
  
  
  Check the "Billed As" Line
&lt;/h3&gt;

&lt;p&gt;Look for wording like "billed as $107.64 for the first 36 months." That line tells you three things: how much you'll actually pay upfront, how long the promo lasts and when the renewal will hit.&lt;/p&gt;

&lt;h3&gt;
  
  
  Compare Monthly Billing
&lt;/h3&gt;

&lt;p&gt;One useful trick: switch the plan to monthly billing on the pricing page. The monthly price is often close to the regular, non-promotional rate, which gives you a good idea of what renewal will look like even when the renewal price isn't obvious.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Hidden Lines in a Yearly Hosting Bill
&lt;/h2&gt;

&lt;p&gt;The hosting plan is rarely the only charge. When you work out the real yearly cost, include everything you'll actually pay for.&lt;/p&gt;

&lt;h3&gt;
  
  
  Domain Renewal
&lt;/h3&gt;

&lt;p&gt;"Free domain" usually means free for the first year. After that, it renews at the host's domain price, which may be higher than a standalone registrar charges. Many developers keep domains at a separate registrar for exactly this reason. It also makes switching hosts much easier later.&lt;/p&gt;

&lt;h3&gt;
  
  
  SSL Certificates
&lt;/h3&gt;

&lt;p&gt;Basic SSL shouldn't cost extra in 2026. &lt;a href="https://letsencrypt.org/about/" rel="noopener noreferrer"&gt;Let's Encrypt&lt;/a&gt; describes itself as "a free, automated, and open Certificate Authority (CA), run for the public's benefit," and most hosts use it or something similar to provide free certificates. If a plan charges for basic SSL, treat that as a red flag. Paid certificates make sense mainly for specific needs, such as organization validation.&lt;/p&gt;

&lt;h3&gt;
  
  
  Backups and Restores
&lt;/h3&gt;

&lt;p&gt;Some plans include daily backups. Others charge for backups as an add-on, or include backups but charge a fee each time you restore one. Check both the backup schedule and whether restores cost extra.&lt;/p&gt;

&lt;h3&gt;
  
  
  Email, Privacy and Security Add-Ons
&lt;/h3&gt;

&lt;p&gt;Common extras include professional email hosting, domain privacy protection, malware scanning and site security bundles. Some are useful, some are upsells and many are pre-selected at checkout. Untick anything you don't need, and note anything you keep in your yearly total.&lt;/p&gt;

&lt;h3&gt;
  
  
  Control Panel Costs
&lt;/h3&gt;

&lt;p&gt;Control panel licenses are part of why hosting prices rise over time. &lt;a href="https://cpanel.net/pricing/" rel="noopener noreferrer"&gt;cPanel's license pricing&lt;/a&gt; is charged to hosts per account, and hosts usually build those costs into plan prices. That isn't a hidden fee you'll see on your invoice, but it helps explain why cPanel-based plans can cost more and why some hosts raise renewal prices after license changes.&lt;/p&gt;

&lt;h3&gt;
  
  
  Setup, Migration and Taxes
&lt;/h3&gt;

&lt;p&gt;Check for one-time setup fees, paid migration services and sales tax or VAT, which may not appear until the last step of checkout.&lt;/p&gt;

&lt;h2&gt;
  
  
  How to Calculate the Real Yearly Cost
&lt;/h2&gt;

&lt;h3&gt;
  
  
  The Formula
&lt;/h3&gt;

&lt;p&gt;The real yearly cost is the total you'll pay over a fair comparison period, divided by the number of years:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Real yearly cost = (promo term cost + renewal terms + recurring add-ons) ÷ years&lt;/strong&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  Why Three Years Is the Fair Window
&lt;/h3&gt;

&lt;p&gt;One year flatters promotional pricing, because it only counts the cheap part. Five years is a long time to predict in hosting. Three years is a practical middle ground: long enough to include at least one renewal, short enough to be realistic.&lt;/p&gt;

&lt;h3&gt;
  
  
  A Worked Example
&lt;/h3&gt;

&lt;p&gt;&lt;em&gt;Host A and Host B are fictional, and their prices are illustrative.&lt;/em&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Host A (promo):&lt;/strong&gt; $2.99 a month for the first 12 months, then $12.99 a month. A free domain for the first year, then $19.99 a year. Backups are a $30 yearly add-on.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Host B (flat):&lt;/strong&gt; $6.99 a month, every year. The domain costs $14.99 a year from the start. Backups are included.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;In year one, Host A looks like the obvious winner: $65.88 against $98.87. But over three years, Host A costs $477.62 and Host B costs $296.61. That's a real yearly cost of $159.21 for Host A and $98.87 for Host B.&lt;/p&gt;

&lt;p&gt;Over five years, the gap widens: $889.36 against $494.35.&lt;/p&gt;

&lt;h2&gt;
  
  
  A Small Script to Compare Any Two Plans
&lt;/h2&gt;

&lt;p&gt;Doing this by hand gets tedious when you're comparing several hosts. Here's a small Node.js script that does it for you. It has no dependencies, so save it as &lt;code&gt;hosting-cost.mjs&lt;/code&gt; and edit the plans array:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// hosting-cost.mjs: compare the real cost of hosting plans over time&lt;/span&gt;
&lt;span class="c1"&gt;// Usage: node hosting-cost.mjs [years]&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;years&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;Number&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;plans&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Host A (promo)&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;introMonthly&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;2.99&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="c1"&gt;// advertised monthly price&lt;/span&gt;
    &lt;span class="na"&gt;introMonths&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;12&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;    &lt;span class="c1"&gt;// promo term, billed upfront&lt;/span&gt;
    &lt;span class="na"&gt;renewMonthly&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;12.99&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;addOnsYearly&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;domain&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;19.99&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;backups&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;30&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt; &lt;span class="c1"&gt;// after any free first year&lt;/span&gt;
    &lt;span class="na"&gt;freeFirstYear&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;domain&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
  &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Host B (flat)&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;introMonthly&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;6.99&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;introMonths&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;12&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;renewMonthly&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;6.99&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;addOnsYearly&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;domain&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;14.99&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="na"&gt;freeFirstYear&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[],&lt;/span&gt;
  &lt;span class="p"&gt;},&lt;/span&gt;
&lt;span class="p"&gt;];&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;costForYear&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;plan&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;year&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;months&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;12&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;monthStart&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;year&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;months&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;hosting&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;m&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;monthStart&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;m&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="nx"&gt;monthStart&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;months&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;m&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nx"&gt;hosting&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="nx"&gt;m&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="nx"&gt;plan&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;introMonths&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="nx"&gt;plan&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;introMonthly&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;plan&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;renewMonthly&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;addOns&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;item&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;price&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nb"&gt;Object&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;entries&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;plan&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;addOnsYearly&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;year&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;plan&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;freeFirstYear&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;includes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;item&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="k"&gt;continue&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="nx"&gt;addOns&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="nx"&gt;price&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;hosting&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;addOns&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;plan&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;plans&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;perYear&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Array&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;length&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;years&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;_&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;costForYear&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;plan&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;total&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;perYear&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;reduce&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;a&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;b&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;a&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;b&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`\n&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;plan&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nx"&gt;perYear&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;forEach&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;c&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`  Year &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;: $&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;c&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toFixed&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
  &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`  Total over &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;years&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; year&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;years&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="dl"&gt;""&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;s&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;: $&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;total&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toFixed&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`  Real yearly cost: $&lt;/span&gt;&lt;span class="p"&gt;${(&lt;/span&gt;&lt;span class="nx"&gt;total&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="nx"&gt;years&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;toFixed&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Running &lt;code&gt;node hosting-cost.mjs&lt;/code&gt; prints:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Host A (promo)
  Year 1: $65.88
  Year 2: $205.87
  Year 3: $205.87
  Total over 3 years: $477.62
  Real yearly cost: $159.21

Host B (flat)
  Year 1: $98.87
  Year 2: $98.87
  Year 3: $98.87
  Total over 3 years: $296.61
  Real yearly cost: $98.87
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Pass a different number of years, such as &lt;code&gt;node hosting-cost.mjs 5&lt;/code&gt;, to see the longer view. For a 36-month promo, set &lt;code&gt;introMonths: 36&lt;/code&gt;, and the script keeps the intro price for three years before switching to the renewal rate.&lt;/p&gt;

&lt;h2&gt;
  
  
  Long Prepay: When It Saves Money and When It Traps You
&lt;/h2&gt;

&lt;p&gt;Prepaying for several years can be a good deal. If the promo price applies to a 36-month term, you lock in a low rate for three years and push the renewal far into the future. Run the numbers with the script, and a long term often wins on total cost.&lt;/p&gt;

&lt;p&gt;But there are trade-offs:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;You're committing to a host you haven't tested.&lt;/strong&gt; Speed, support quality and uptime are hard to judge before you've used them.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Refunds are often limited.&lt;/strong&gt; Many hosts offer a money-back window of a few weeks, after which refunds may be prorated, reduced by fees or not available at all. Domains are often non-refundable.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The renewal still comes.&lt;/strong&gt; A long promo delays the price jump but doesn't remove it.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;A sensible approach is to start with a shorter term, or use the money-back window to test performance and support properly, then commit to a longer term once you're confident.&lt;/p&gt;

&lt;h2&gt;
  
  
  Auto-Renewal Rules and Reminders
&lt;/h2&gt;

&lt;p&gt;Most hosting plans renew automatically. That protects your site from going offline, but it also means the higher price is charged without you lifting a finger.&lt;/p&gt;

&lt;p&gt;Some places require advance notice. In California, the automatic renewal law, found in &lt;a href="https://leginfo.legislature.ca.gov/faces/codes_displaySection.xhtml?lawCode=BPC&amp;amp;sectionNum=17602" rel="noopener noreferrer"&gt;California Business and Professions Code section 17602&lt;/a&gt;, was updated with changes that took effect on July 1, 2025. Under those changes, businesses must notify consumers of a price change at least 7 days and no more than 30 days before the new price takes effect, and send an annual reminder about the subscription. Rules vary by state and country, and they may not apply to every business account, so don't rely on getting a warning. This is general information, not legal advice.&lt;/p&gt;

&lt;p&gt;The practical fix is simple:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Put the renewal date in your calendar&lt;/strong&gt; a month ahead.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Check which card is on file,&lt;/strong&gt; so a renewal doesn't fail and take your site offline.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Decide on purpose&lt;/strong&gt; whether to renew, switch billing or move.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  What to Do When the Renewal Email Arrives
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Ask for a better rate.&lt;/strong&gt; Contact support or the billing team and ask whether they can offer a lower renewal price. Some hosts have retention offers. Others don't, but asking costs nothing.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Change the billing term.&lt;/strong&gt; A shorter term may cost more per month but less upfront. A longer term may lock in a better rate if you're happy with the host.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Downgrade the plan.&lt;/strong&gt; If you're paying for websites, storage or features you don't use, a smaller plan may fit.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Move hosts.&lt;/strong&gt; If the numbers don't work, migrating is often easier than it looks:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Choose and set up the new host, ideally before the old plan renews.&lt;/li&gt;
&lt;li&gt;Take full backups of files, databases and email.&lt;/li&gt;
&lt;li&gt;Lower your DNS records' TTL a day or two ahead, so changes take effect faster.&lt;/li&gt;
&lt;li&gt;Copy the site to the new host and test it using a temporary URL or your hosts file.&lt;/li&gt;
&lt;li&gt;Move email carefully, or switch to a separate email provider.&lt;/li&gt;
&lt;li&gt;Update DNS, then keep the old account active for a few days until traffic has fully moved.&lt;/li&gt;
&lt;li&gt;Cancel the old plan and turn off auto-renewal.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Keeping your domain at a separate registrar makes every future move simpler.&lt;/p&gt;

&lt;h2&gt;
  
  
  A Checklist Before You Buy
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Do I know the &lt;strong&gt;renewal price&lt;/strong&gt;, not just the intro price?&lt;/li&gt;
&lt;li&gt;How long is the &lt;strong&gt;promo term&lt;/strong&gt;, and is it billed upfront?&lt;/li&gt;
&lt;li&gt;What does the &lt;strong&gt;domain&lt;/strong&gt; cost after the first year?&lt;/li&gt;
&lt;li&gt;Is &lt;strong&gt;SSL&lt;/strong&gt; free?&lt;/li&gt;
&lt;li&gt;Are &lt;strong&gt;backups and restores&lt;/strong&gt; included?&lt;/li&gt;
&lt;li&gt;Which &lt;strong&gt;add-ons&lt;/strong&gt; are pre-selected at checkout?&lt;/li&gt;
&lt;li&gt;What is the &lt;strong&gt;refund policy&lt;/strong&gt; after the money-back window?&lt;/li&gt;
&lt;li&gt;What's the &lt;strong&gt;real yearly cost&lt;/strong&gt; over three years?&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Nexi Bloom, for example, lists both monthly and yearly prices for its shared hosting plans, with free SSL on every plan and a free domain on its Micro and Mega plans. As with any host, confirm the renewal rate and the real yearly cost before you buy. You can compare the &lt;a href="https://nexibloom.com/web-hosting" rel="noopener noreferrer"&gt;Nexi Bloom web hosting plans&lt;/a&gt;, or look at &lt;a href="https://nexibloom.com/wordpress-hosting" rel="noopener noreferrer"&gt;managed WordPress hosting&lt;/a&gt; if your site runs on WordPress.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQs
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Why does web hosting cost more when it renews?
&lt;/h3&gt;

&lt;p&gt;Many hosts use low introductory prices to win new customers, then charge their regular rate when the first term ends. The promo often requires a long prepaid term, and free extras such as a domain usually renew at full price, so the jump at renewal can be large.&lt;/p&gt;

&lt;h3&gt;
  
  
  Can I keep the introductory price when I renew?
&lt;/h3&gt;

&lt;p&gt;Usually not, because promotional prices typically apply only to the first term. Some hosts will offer a retention discount if you ask, especially if you're considering leaving. Prepaying for a longer first term is another way to keep a lower rate for longer.&lt;/p&gt;

&lt;h3&gt;
  
  
  Is it cheaper to pay for hosting for 3 years upfront?
&lt;/h3&gt;

&lt;p&gt;Often, yes, because the promo price may apply to the whole 36-month term. But you pay everything upfront, refunds may be limited after the money-back window and the renewal still comes eventually. Test the host first if you can, and compare total cost over three years.&lt;/p&gt;

&lt;h3&gt;
  
  
  How much should web hosting cost per year?
&lt;/h3&gt;

&lt;p&gt;It depends on the type of hosting and what's included. Compare plans by their real yearly cost over three years, including the renewal price, domain, backups and any add-ons, rather than the advertised monthly price. That shows what you'll actually pay once the promo ends.&lt;/p&gt;

&lt;h3&gt;
  
  
  Can I negotiate my hosting renewal price?
&lt;/h3&gt;

&lt;p&gt;Sometimes. Contact your host's support or billing team before the renewal date and ask about retention offers or alternative plans. Results vary by provider. If they can't help, compare other hosts' real yearly costs and consider moving.&lt;/p&gt;

&lt;h3&gt;
  
  
  Is the free domain with hosting really free?
&lt;/h3&gt;

&lt;p&gt;Usually only for the first year. After that, it renews at the host's domain price, which may be higher than a standalone registrar charges. Check the renewal price before you accept, and consider registering your domain separately so it's easier to change hosts later.&lt;/p&gt;

&lt;h3&gt;
  
  
  How do I stop my hosting from auto-renewing?
&lt;/h3&gt;

&lt;p&gt;Most hosts let you turn off auto-renewal in your account's billing or services section. Check the exact steps in your host's help center, and make sure your site and email are moved or backed up first, because the service may stop when the term ends.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrapping Up
&lt;/h2&gt;

&lt;p&gt;Hosting renewal price jumps are predictable once you know where to look. Find the renewal rate and the "billed as" line, add the domain, backups and other extras, then compare the real yearly cost over three years. Put the renewal date in your calendar, and you'll make the decision on your terms instead of the host's.&lt;/p&gt;

</description>
      <category>webdev</category>
      <category>hosting</category>
      <category>beginners</category>
      <category>devops</category>
    </item>
    <item>
      <title>Choosing a Front End Framework for a Marketing Site</title>
      <dc:creator>Jay Barker</dc:creator>
      <pubDate>Mon, 09 Nov 2026 02:03:52 +0000</pubDate>
      <link>https://dev.to/jaybarker/choosing-a-front-end-framework-for-a-marketing-site-19c8</link>
      <guid>https://dev.to/jaybarker/choosing-a-front-end-framework-for-a-marketing-site-19c8</guid>
      <description>&lt;p&gt;The marketing team wants a new website. The product team already builds in React. Then someone on a call asks, "Why not Nuxt? It's simpler." Half the room nods, the other half opens a comparison article that turns out to be about building dashboards.&lt;/p&gt;

&lt;p&gt;That's the problem with most Next.js vs Nuxt comparisons. They judge both frameworks as app platforms: server actions, authentication, real-time data. A marketing site needs something different. It needs fast, mostly static pages, solid SEO, an easy way for editors to publish and hosting that doesn't cost more than the site earns.&lt;/p&gt;

&lt;p&gt;This post compares Next.js and Nuxt through that lens, with current versions, working config snippets and an honest look at when a plain static site generator is the better choice.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Short Answer
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Choose Next.js&lt;/strong&gt; if your team knows React, or if the marketing site shares components, design systems or authentication with a React product.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Choose Nuxt&lt;/strong&gt; if your team knows Vue, or if you want a framework that deploys cleanly to almost any host with very little configuration.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Choose a static site generator&lt;/strong&gt; such as Astro, Eleventy or Hugo if the site is almost entirely content and doesn't need to share code with an app.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Both Next.js and Nuxt can produce fast, well-optimized marketing sites. The bigger decision is usually your team, not the framework.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where Both Stand in Late 2026
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Next.js 16.4
&lt;/h3&gt;

&lt;p&gt;Next.js 16.4 shipped on October 6, 2026. The headline change is Cache Components, a model where you mark parts of the component tree as cacheable with &lt;code&gt;'use cache'&lt;/code&gt;. The release post puts it plainly: "Starting with Next.js 16.4, we're excited to recommend Cache Components as the best choice for every Next.js app," and new apps created with &lt;code&gt;create-next-app&lt;/code&gt; now have it on by default. It also ships with React 19.3.&lt;/p&gt;

&lt;p&gt;For marketing sites, the most useful addition is &lt;code&gt;ensureStatic&lt;/code&gt;, which fails the build if dynamic content sneaks into a page that should be static. The Next.js team names "marketing pages" as one of the cases it's designed for.&lt;/p&gt;

&lt;h3&gt;
  
  
  Nuxt 4.5
&lt;/h3&gt;

&lt;p&gt;Nuxt 4.5 moves to Vite 8, adds experimental SSR streaming (off by default) and introduces stable error codes with suggested fixes. The team says its focus is now shifting to "stabilising Nuxt v5," and you can already opt into some v5 changes with &lt;code&gt;future.compatibilityVersion: 5&lt;/code&gt;.&lt;/p&gt;

&lt;h3&gt;
  
  
  NuxtLabs and Vercel
&lt;/h3&gt;

&lt;p&gt;In July 2025, NuxtLabs, the company behind much of Nuxt's development, joined Vercel, the company behind Next.js. Some teams worried this meant Nuxt would become Vercel-only. &lt;a href="https://vercel.com/blog/nuxtlabs-joins-vercel" rel="noopener noreferrer"&gt;Vercel's NuxtLabs announcement&lt;/a&gt; says that "Nuxt and Nitro will remain independent, open source projects with an MIT license, public roadmap, and open governance." In practice, Nuxt still deploys to many hosts, and that's the main thing a marketing site cares about.&lt;/p&gt;

&lt;h2&gt;
  
  
  What a Marketing Site Actually Needs
&lt;/h2&gt;

&lt;p&gt;Before comparing features, list what the site has to do. For most marketing sites, that's:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Static or cached pages,&lt;/strong&gt; so every visitor gets fast HTML&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Good Largest Contentful Paint (LCP)&lt;/strong&gt; on phones, especially for hero images&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Full control over meta tags,&lt;/strong&gt; Open Graph tags and canonical URLs&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A sitemap and redirects&lt;/strong&gt; that are easy to maintain&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Forms&lt;/strong&gt; for leads, demos and newsletter signups&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Easy publishing for non-developers,&lt;/strong&gt; usually through a headless CMS or Markdown&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Preview&lt;/strong&gt; of draft content before it goes live&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Low, predictable hosting costs&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Notice what's missing: complex server logic, real-time data and user dashboards. If your marketing site needs those, it's really an app with marketing pages, which changes the comparison.&lt;/p&gt;

&lt;h2&gt;
  
  
  Rendering for Marketing Pages
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Next.js: Static by Default, Fully Static if You Want
&lt;/h3&gt;

&lt;p&gt;Next.js prerenders pages at build time whenever it can. For a site that should never need a server, you can produce a fully static build. The &lt;a href="https://nextjs.org/docs/app/guides/static-exports" rel="noopener noreferrer"&gt;Next.js static exports guide&lt;/a&gt; shows the setting:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// next.config.js&lt;/span&gt;
&lt;span class="cm"&gt;/** @type {import('next').NextConfig} */&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;nextConfig&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="na"&gt;output&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;export&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="c1"&gt;// Optional: emit /about/index.html instead of /about.html&lt;/span&gt;
  &lt;span class="na"&gt;trailingSlash&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="nx"&gt;module&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;exports&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;nextConfig&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Running &lt;code&gt;next build&lt;/code&gt; then creates an &lt;code&gt;out&lt;/code&gt; folder of HTML, CSS and JavaScript that any static host can serve.&lt;/p&gt;

&lt;p&gt;There's a trade-off. A static export can't use features that need a server, including redirects, rewrites and headers in &lt;code&gt;next.config.js&lt;/code&gt;, incremental static regeneration (ISR), Server Actions and image optimization with the default loader. For a marketing site, that usually means handling redirects at your host or CDN and using a custom image loader or pre-optimized images.&lt;/p&gt;

&lt;p&gt;If you want the server features but still want marketing pages guaranteed static, Next.js 16.4's &lt;code&gt;ensureStatic&lt;/code&gt; is a good fit. It belongs to the Cache Components model, so it needs &lt;code&gt;cacheComponents&lt;/code&gt; enabled. New &lt;code&gt;create-next-app&lt;/code&gt; projects have it on already, and existing apps can add it:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// next.config.ts&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;NextConfig&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;next&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;nextConfig&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;NextConfig&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="na"&gt;cacheComponents&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="nx"&gt;nextConfig&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Then add &lt;code&gt;ensureStatic&lt;/code&gt; to the root layout:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// app/layout.tsx&lt;/span&gt;
&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;ensureStatic&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;navigation&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;RootLayout&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
  &lt;span class="nx"&gt;children&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;children&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;React&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;ReactNode&lt;/span&gt;
&lt;span class="p"&gt;})&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;return &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;html&lt;/span&gt; &lt;span class="na"&gt;lang&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"en"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;body&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;children&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;body&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;html&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;With that in place, the build fails if any page tries to render at request time. In a quick test on Next.js 16.4, a page that read cookies stopped the build with an error saying the route "must be fully static," which is exactly the guardrail a marketing site wants. You can relax it for specific sections later if they need dynamic content.&lt;/p&gt;

&lt;h3&gt;
  
  
  Nuxt: Generate Everything, or Mix Per Route
&lt;/h3&gt;

&lt;p&gt;Nuxt gives you two main options. The simplest is &lt;code&gt;nuxt generate&lt;/code&gt;, which, according to the &lt;a href="https://nuxt.com/docs/guide/concepts/rendering" rel="noopener noreferrer"&gt;Nuxt rendering modes&lt;/a&gt; documentation, will "render every page as a separate static HTML file" by default.&lt;/p&gt;

&lt;p&gt;The more flexible option is hybrid rendering. Nuxt's docs explain that "Hybrid rendering allows different caching rules per route using Route Rules." For a marketing site, that might look like this:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// nuxt.config.ts&lt;/span&gt;
&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="nf"&gt;defineNuxtConfig&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
  &lt;span class="na"&gt;routeRules&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="c1"&gt;// Prerender at build time&lt;/span&gt;
    &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;prerender&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/pricing&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;prerender&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="c1"&gt;// Serve cached pages, regenerate in the background hourly&lt;/span&gt;
    &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/blog/**&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;swr&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;3600&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="c1"&gt;// Old URL moved permanently&lt;/span&gt;
    &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/features-old&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;redirect&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;to&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/features&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;statusCode&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;301&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;},&lt;/span&gt;
&lt;span class="p"&gt;})&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;In a test build on Nuxt 4.5, the old URL returned a proper 301 to &lt;code&gt;/features&lt;/code&gt; and the prerendered pages served as static HTML. This is one of Nuxt's real strengths for marketing teams. Rendering, caching and redirects sit in one readable config block.&lt;/p&gt;

&lt;h3&gt;
  
  
  The Catch With Nuxt's Static Mode
&lt;/h3&gt;

&lt;p&gt;Hybrid rendering needs a server or serverless runtime. The Nuxt docs are clear that "Hybrid Rendering is not available when using nuxt generate." So if you want a purely static build, you're back to rendering everything at build time, much like Next.js's static export.&lt;/p&gt;

&lt;h2&gt;
  
  
  SEO and Core Web Vitals in Practice
&lt;/h2&gt;

&lt;p&gt;Both frameworks give you full control over SEO basics. Next.js uses its Metadata API, exporting a &lt;code&gt;metadata&lt;/code&gt; object or a &lt;code&gt;generateMetadata&lt;/code&gt; function from each page. Nuxt uses composables such as &lt;code&gt;useSeoMeta&lt;/code&gt; and &lt;code&gt;useHead&lt;/code&gt;. Both handle titles, descriptions, canonical URLs and Open Graph tags cleanly, and both can generate sitemaps through built-in features or well-maintained modules.&lt;/p&gt;

&lt;p&gt;On performance, you'll find benchmarks claiming either framework is faster. Most measure server throughput for simple pages or apps, which tells you little about a marketing site served from a CDN. When pages are prerendered, real-world speed depends mostly on what you ship:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Hero image size and format,&lt;/strong&gt; usually the biggest factor in LCP&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Third-party scripts,&lt;/strong&gt; such as chat widgets, analytics and tag managers&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;How much JavaScript&lt;/strong&gt; each page hydrates&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Fonts,&lt;/strong&gt; and whether they block rendering&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;A lean Nuxt site and a lean Next.js site will both score well. A bloated one will score badly in either framework. Measure your own pages with PageSpeed Insights or your Core Web Vitals data rather than trusting a generic benchmark.&lt;/p&gt;

&lt;h2&gt;
  
  
  Content and Editor Workflow
&lt;/h2&gt;

&lt;p&gt;Most marketing sites are edited by people who don't write code, so the publishing workflow matters as much as the framework.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Headless CMS.&lt;/strong&gt; Both frameworks work well with headless CMSs such as Contentful, Sanity, Storyblok, Strapi and WordPress through its API. Check the CMS's official starter or SDK for your framework, since quality varies.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Preview.&lt;/strong&gt; Next.js has Draft Mode for previewing unpublished content, though it needs a server, so it isn't available in a static export. Nuxt projects typically handle preview through the CMS's own module or a server route.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Markdown and MDX.&lt;/strong&gt; If developers or technical marketers write content in Markdown, Nuxt Content is a polished option with querying built in. On the React side, MDX lets you mix Markdown with components.&lt;/p&gt;

&lt;p&gt;If WordPress is your likely CMS, our earlier look at headless WordPress with Next.js covers whether going headless is worth the extra complexity at all.&lt;/p&gt;

&lt;h2&gt;
  
  
  Hosting and Cost
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Next.js&lt;/strong&gt; runs best on Vercel, where features like ISR, image optimization and Cache Components work without configuration. It also runs on any Node.js server, in containers or as a static export on any static host. Some advanced features take more setup outside Vercel, so check your host's Next.js support before committing.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Nuxt&lt;/strong&gt; is built on Nitro, which ships deployment presets for many platforms, including Vercel, Netlify, Cloudflare, Node.js servers and static hosting. Moving a Nuxt site between hosts is usually a matter of changing a preset.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Static output&lt;/strong&gt; is the cheapest option either way. A fully static marketing site can sit on a CDN or static host for little or nothing per month, with no servers to patch. Only pay for server rendering if a feature truly needs it, such as personalization, on-demand regeneration or server-side preview.&lt;/p&gt;

&lt;h2&gt;
  
  
  Team and Hiring
&lt;/h2&gt;

&lt;p&gt;React has the larger talent pool, which makes Next.js easier to staff and easier to hand to an agency. Vue is often considered gentler to learn, and many developers find Nuxt's conventions, such as auto-imports and file-based everything, quick to pick up.&lt;/p&gt;

&lt;p&gt;The most useful question is simple: who will maintain this site in two years? If your product team writes React and will inherit the marketing site, Next.js keeps everything in one ecosystem. If your marketing site has its own small team that already knows Vue, Nuxt is the natural choice. Switching ecosystems for a marketing site rarely pays off.&lt;/p&gt;

&lt;h2&gt;
  
  
  When a Static Site Generator Beats Both
&lt;/h2&gt;

&lt;p&gt;Not every marketing site needs a full application framework. If your site is mostly pages, a blog and a few forms, a static site generator such as Astro, Eleventy or Hugo can be simpler and faster:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Less JavaScript by default.&lt;/strong&gt; Astro, for example, ships HTML and adds JavaScript only to components that need it.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Fewer moving parts&lt;/strong&gt; to update, secure and debug&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cheap, simple hosting&lt;/strong&gt; on any static host&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Stay with Next.js or Nuxt when the marketing site genuinely shares components, design systems, authentication or data with a product, or when you expect it to grow app-like features such as calculators, gated content or customer logins.&lt;/p&gt;

&lt;h2&gt;
  
  
  A Decision Checklist
&lt;/h2&gt;

&lt;p&gt;Answer these before you choose:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Does your team already work mainly in React or in Vue?&lt;/li&gt;
&lt;li&gt;Will the marketing site share components or authentication with a product?&lt;/li&gt;
&lt;li&gt;Can every page be prerendered at build time?&lt;/li&gt;
&lt;li&gt;Do editors need live preview of draft content?&lt;/li&gt;
&lt;li&gt;Where will you host it, and does that host fully support your framework's features?&lt;/li&gt;
&lt;li&gt;Who will maintain it in two years?&lt;/li&gt;
&lt;li&gt;Would a static site generator cover everything you need?&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;If the marketing site sits alongside a product or customer portal and needs to share code with it, Raydiant Webs builds &lt;a href="https://raydiantwebs.com/services/web-app-development" rel="noopener noreferrer"&gt;custom web app development&lt;/a&gt; projects with React, Next.js and TypeScript. For a standalone marketing site, its &lt;a href="https://raydiantwebs.com/services/web-development" rel="noopener noreferrer"&gt;web development for marketing sites&lt;/a&gt; service helps you choose a platform based on budget, timeline and how your team will manage the site.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQs
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Is Nuxt better than Next.js?
&lt;/h3&gt;

&lt;p&gt;Neither is better overall. Next.js has the larger ecosystem and talent pool, plus deep integration with Vercel. Nuxt offers simple per-route rendering rules, auto-imports and easy deployment to many hosts. For a marketing site, the best choice is usually the one built on the library your team already knows, React or Vue.&lt;/p&gt;

&lt;h3&gt;
  
  
  Is Next.js good for marketing websites and SEO?
&lt;/h3&gt;

&lt;p&gt;Yes. Next.js prerenders pages at build time, supports full static exports and gives you complete control over metadata, canonical URLs and Open Graph tags. Next.js 16.4 adds &lt;code&gt;ensureStatic&lt;/code&gt; to guarantee pages stay static. SEO results depend more on content, page speed and site structure than on the framework itself.&lt;/p&gt;

&lt;h3&gt;
  
  
  Can Nuxt generate a static site?
&lt;/h3&gt;

&lt;p&gt;Yes. Running &lt;code&gt;nuxt generate&lt;/code&gt; renders every page as a static HTML file that any static host can serve. Note that hybrid rendering with route rules, such as &lt;code&gt;swr&lt;/code&gt; caching per route, needs a server or serverless runtime and isn't available with &lt;code&gt;nuxt generate&lt;/code&gt;.&lt;/p&gt;

&lt;h3&gt;
  
  
  Is Nuxt owned by Vercel now?
&lt;/h3&gt;

&lt;p&gt;NuxtLabs, the company behind much of Nuxt's development, joined Vercel in July 2025. Vercel says Nuxt and Nitro remain independent, open source projects with an MIT license, public roadmap and open governance. Nuxt still deploys to many hosts beyond Vercel.&lt;/p&gt;

&lt;h3&gt;
  
  
  Do I need Vercel to host Next.js?
&lt;/h3&gt;

&lt;p&gt;No. Next.js runs on any Node.js server, in containers or as a static export on any static host. Vercel offers the smoothest experience, and some advanced features take extra configuration elsewhere, so check your host's Next.js support for features like ISR and image optimization.&lt;/p&gt;

&lt;h3&gt;
  
  
  Which is faster, Next.js or Nuxt?
&lt;/h3&gt;

&lt;p&gt;For prerendered marketing pages served from a CDN, the difference is usually small. Real-world speed depends mostly on image sizes, third-party scripts, fonts and how much JavaScript each page hydrates. Measure your own pages with PageSpeed Insights rather than relying on generic framework benchmarks.&lt;/p&gt;

&lt;h3&gt;
  
  
  Should I use Astro instead of Next.js for a marketing site?
&lt;/h3&gt;

&lt;p&gt;Consider it if your site is mostly content and doesn't share code with a product. Astro ships very little JavaScript by default and keeps things simple. Next.js or Nuxt make more sense when the site shares components or authentication with an app, or needs app-like features.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrapping Up
&lt;/h2&gt;

&lt;p&gt;For a marketing site, the Next.js vs Nuxt decision comes down to your team and your hosting more than the frameworks themselves. Both can prerender every page, both handle SEO well and both can be fast. Pick the one built on the library your team knows, keep pages static wherever you can and seriously consider a static site generator if the site is mostly content.&lt;/p&gt;

</description>
      <category>nextjs</category>
      <category>nuxt</category>
      <category>webdev</category>
      <category>javascript</category>
    </item>
    <item>
      <title>Favicon Basics: Sizes, Formats and Why Your Site Needs One</title>
      <dc:creator>Jay Barker</dc:creator>
      <pubDate>Sat, 07 Nov 2026 15:48:39 +0000</pubDate>
      <link>https://dev.to/jaybarker/favicon-basics-sizes-formats-and-why-your-site-needs-one-30a</link>
      <guid>https://dev.to/jaybarker/favicon-basics-sizes-formats-and-why-your-site-needs-one-30a</guid>
      <description>&lt;p&gt;You have 14 tabs open. Every one of them shows a small logo except yours, which shows a blank page or a gray globe. Or you search for your business on your phone and see competitors' logos beside their results, while yours has a generic placeholder.&lt;/p&gt;

&lt;p&gt;A favicon is the smallest piece of your brand, but it appears almost everywhere your site does. It's also an area full of outdated advice. Many size lists online still recommend a dozen Apple, Windows and Opera icons that modern devices no longer use.&lt;/p&gt;

&lt;p&gt;This guide explains why your site needs a favicon, which favicon sizes and formats actually matter in 2026, Google Search's favicon rules, the HTML to use, how to create the files with a favicon generator or a short script, and how to test the result.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Disclosure:&lt;/strong&gt; Jay Barker writes for SEO Site Checker, whose free favicon generator is mentioned below. Everything else in this guide works with any tool.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  Why Your Site Needs a Favicon
&lt;/h2&gt;

&lt;p&gt;Favicons appear in more places than most people realize:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Browser tabs, bookmarks and history,&lt;/strong&gt; where they help people find your site among dozens of others&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Home screen shortcuts&lt;/strong&gt; on iPhones, iPads and Android devices&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Installed web apps&lt;/strong&gt; and progressive web apps&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Google's search results,&lt;/strong&gt; where a small icon appears beside your site name, most visibly on mobile&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;They also signal that a site is finished and cared for. As &lt;a href="https://evilmartians.com/chronicles/how-to-favicon-in-2021-six-files-that-fit-most-needs" rel="noopener noreferrer"&gt;Evil Martians' guide to the minimal favicon set&lt;/a&gt; puts it, "Users expect your website to have a favicon."&lt;/p&gt;

&lt;p&gt;There's a technical reason too. Browsers often request &lt;code&gt;/favicon.ico&lt;/code&gt; automatically, even if you never link to it. Without one, your server logs fill with 404 errors.&lt;/p&gt;

&lt;p&gt;A favicon isn't a direct ranking factor. But a clear, recognizable icon can help your result stand out in a crowded search page and makes your brand easier to spot in a row of open tabs.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Favicon Sizes You Actually Need in 2026
&lt;/h2&gt;

&lt;h3&gt;
  
  
  The Minimal Modern Set
&lt;/h3&gt;

&lt;p&gt;Evil Martians' widely referenced guide, last updated in January 2026, recommends a small set of files that covers almost every case:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;favicon.ico&lt;/code&gt; (32×32)&lt;/strong&gt; in your site's root folder, for older browsers and tools that request it automatically&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;icon.svg&lt;/code&gt;&lt;/strong&gt;, a scalable vector icon for modern browsers, which can also switch colors in dark mode&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;apple-touch-icon.png&lt;/code&gt; (180×180)&lt;/strong&gt; for iPhone and iPad home screen shortcuts&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;icon-192.png&lt;/code&gt; and &lt;code&gt;icon-512.png&lt;/code&gt;&lt;/strong&gt;, referenced in a web app manifest for Android and installable web apps&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;icon-mask.png&lt;/code&gt; (512×512, optional)&lt;/strong&gt;, a "maskable" icon for Android's adaptive icon shapes, with the logo kept inside a central 409×409 safe zone&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That's five or six files in total, each with a specific job.&lt;/p&gt;

&lt;h3&gt;
  
  
  Sizes You Can Skip
&lt;/h3&gt;

&lt;p&gt;Older guides often list icons that modern browsers and devices no longer need:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Multiple Apple sizes such as 57, 72, 114 and 152 pixels. One 180×180 icon is enough&lt;/li&gt;
&lt;li&gt;Windows tile images and &lt;code&gt;msapplication&lt;/code&gt; meta tags&lt;/li&gt;
&lt;li&gt;Safari pinned tab mask icons&lt;/li&gt;
&lt;li&gt;Opera Coast's 228×228 icon&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;According to Evil Martians, Windows tiles, Safari mask icons and Opera Coast icons are no longer necessary.&lt;/p&gt;

&lt;h3&gt;
  
  
  What About 16, 48 and Other PNG Sizes?
&lt;/h3&gt;

&lt;p&gt;Many favicon generators also output 16×16, 32×32 and 48×48 PNGs. They're harmless, and they can help older browsers, but they're optional in a modern setup. Browsers can scale down larger images, and Evil Martians notes that "Browsers download favicons in the background, so a bigger favicon image does not affect website performance."&lt;/p&gt;

&lt;p&gt;For Google Search specifically, larger is better. &lt;a href="https://developers.google.com/search/docs/appearance/favicon-in-search" rel="noopener noreferrer"&gt;Google's favicon guidelines for Search&lt;/a&gt; recommend "a favicon that's larger than 48x48px so that it looks good on various surfaces." An ICO file that includes a 48×48 image works, but a larger PNG gives Google more to work with.&lt;/p&gt;

&lt;h2&gt;
  
  
  Formats: ICO vs PNG vs SVG
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;ICO&lt;/strong&gt; is a container format that can hold several image sizes in one file. It's the best fallback for older browsers and for anything that requests &lt;code&gt;/favicon.ico&lt;/code&gt; directly.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;PNG&lt;/strong&gt; is a simple, widely supported image format. Use it for the Apple touch icon and the manifest icons.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;SVG&lt;/strong&gt; is a vector format, so it stays sharp at any size. It also supports CSS, which means one file can switch colors for dark mode. According to Can I Use, SVG favicons are now supported in current versions of Chrome, Edge and Firefox, and in Safari from version 26 on both desktop and iOS. Earlier Safari versions don't support them, which is one reason to keep an ICO fallback.&lt;/p&gt;

&lt;p&gt;There's one more reason not to rely on SVG alone. Google Search lists its supported favicon formats as "BMP, GIF, ICO, PNG, JPEG, PPM, and TIFF," and SVG isn't on that list. Keep an ICO or PNG favicon declared alongside your SVG.&lt;/p&gt;

&lt;p&gt;Whatever the format, design for tiny sizes. A detailed logo with fine text often becomes a smudge at 16 pixels. Most brands use a simplified mark, an initial or a single shape.&lt;/p&gt;

&lt;h2&gt;
  
  
  The HTML
&lt;/h2&gt;

&lt;p&gt;Add these four lines to the &lt;code&gt;&amp;lt;head&amp;gt;&lt;/code&gt; of every page, or at least your home page and templates:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;link&lt;/span&gt; &lt;span class="na"&gt;rel=&lt;/span&gt;&lt;span class="s"&gt;"icon"&lt;/span&gt; &lt;span class="na"&gt;href=&lt;/span&gt;&lt;span class="s"&gt;"/favicon.ico"&lt;/span&gt; &lt;span class="na"&gt;sizes=&lt;/span&gt;&lt;span class="s"&gt;"32x32"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;link&lt;/span&gt; &lt;span class="na"&gt;rel=&lt;/span&gt;&lt;span class="s"&gt;"icon"&lt;/span&gt; &lt;span class="na"&gt;href=&lt;/span&gt;&lt;span class="s"&gt;"/icon.svg"&lt;/span&gt; &lt;span class="na"&gt;type=&lt;/span&gt;&lt;span class="s"&gt;"image/svg+xml"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;link&lt;/span&gt; &lt;span class="na"&gt;rel=&lt;/span&gt;&lt;span class="s"&gt;"apple-touch-icon"&lt;/span&gt; &lt;span class="na"&gt;href=&lt;/span&gt;&lt;span class="s"&gt;"/apple-touch-icon.png"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;link&lt;/span&gt; &lt;span class="na"&gt;rel=&lt;/span&gt;&lt;span class="s"&gt;"manifest"&lt;/span&gt; &lt;span class="na"&gt;href=&lt;/span&gt;&lt;span class="s"&gt;"/manifest.webmanifest"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The &lt;code&gt;sizes="32x32"&lt;/code&gt; attribute on the ICO line matters. Evil Martians recommends it to avoid a Chrome bug where the browser chooses the ICO over the SVG.&lt;/p&gt;

&lt;p&gt;Avoid &lt;code&gt;rel="shortcut icon"&lt;/code&gt;, which still appears in many tutorials. Evil Martians notes that &lt;code&gt;shortcut&lt;/code&gt; was never a valid link relation, and &lt;code&gt;rel="icon"&lt;/code&gt; is the correct form.&lt;/p&gt;

&lt;p&gt;The manifest file lists the larger icons for Android and installable web apps:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"name"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Example Site"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"icons"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"src"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"/icon-192.png"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"image/png"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"sizes"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"192x192"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"src"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"/icon-512.png"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"image/png"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"sizes"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"512x512"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"src"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"/icon-mask.png"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"image/png"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"sizes"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"512x512"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"purpose"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"maskable"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;a href="https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest/Reference/icons" rel="noopener noreferrer"&gt;MDN's web app manifest icons reference&lt;/a&gt; explains that a maskable icon is "designed with icon masks and safe zone in mind, such that any part of the image outside the safe zone can be ignored and masked away."&lt;/p&gt;

&lt;p&gt;And here's a simple SVG favicon that switches colors in dark mode:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;svg&lt;/span&gt; &lt;span class="na"&gt;xmlns=&lt;/span&gt;&lt;span class="s"&gt;"http://www.w3.org/2000/svg"&lt;/span&gt; &lt;span class="na"&gt;viewBox=&lt;/span&gt;&lt;span class="s"&gt;"0 0 32 32"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;style&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;rect&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="py"&gt;fill&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;#1f6feb&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="k"&gt;@media&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;prefers-color-scheme&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;dark&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nt"&gt;rect&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="py"&gt;fill&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;#79c0ff&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;/style&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;rect&lt;/span&gt; &lt;span class="na"&gt;width=&lt;/span&gt;&lt;span class="s"&gt;"32"&lt;/span&gt; &lt;span class="na"&gt;height=&lt;/span&gt;&lt;span class="s"&gt;"32"&lt;/span&gt; &lt;span class="na"&gt;rx=&lt;/span&gt;&lt;span class="s"&gt;"6"&lt;/span&gt;&lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;/svg&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Save that as &lt;code&gt;icon.svg&lt;/code&gt; in your site's root folder, and replace the shape with your own simplified logo.&lt;/p&gt;

&lt;h2&gt;
  
  
  Generating the Files
&lt;/h2&gt;

&lt;h3&gt;
  
  
  With an Online Favicon Generator
&lt;/h3&gt;

&lt;p&gt;The quickest route is a favicon generator. SEO Site Checker's &lt;a href="https://seositechecker.pro/favicon-generator" rel="noopener noreferrer"&gt;free favicon generator&lt;/a&gt; takes one square image and returns a ZIP containing a multi-size &lt;code&gt;favicon.ico&lt;/code&gt; (16, 32 and 48 pixels), PNG icons, a 180×180 Apple touch icon, 192×192 and 512×512 Android icons, a web manifest and a ready-to-paste HTML snippet. It doesn't produce an SVG, so add your own &lt;code&gt;icon.svg&lt;/code&gt; if you want dark mode support. Its &lt;a href="https://seositechecker.pro/post/favicon-generator-free" rel="noopener noreferrer"&gt;step-by-step favicon install guide&lt;/a&gt; covers installing the files on common platforms.&lt;/p&gt;

&lt;p&gt;A few tips for the source image:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Make it square,&lt;/strong&gt; ideally 512×512 pixels or larger&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Keep it simple,&lt;/strong&gt; so it still reads at tiny sizes&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Use a solid or transparent background&lt;/strong&gt; that works on both light and dark browser themes&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Keep the file light.&lt;/strong&gt; An &lt;a href="https://seositechecker.pro/image-compressor" rel="noopener noreferrer"&gt;image compressor&lt;/a&gt; can shrink a heavy source PNG before you upload it&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  With a Short Script
&lt;/h3&gt;

&lt;p&gt;If you prefer to build icons in your own workflow, this Node script uses &lt;code&gt;sharp&lt;/code&gt; to create the PNG set, including a maskable icon with the logo inside the 409×409 safe zone:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// make-icons.mjs: build a modern favicon set from one square source image&lt;/span&gt;
&lt;span class="c1"&gt;// Usage: npm install sharp &amp;amp;&amp;amp; node make-icons.mjs logo.png&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nx"&gt;sharp&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;sharp&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;mkdirSync&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;node:fs&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;src&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;logo.png&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;out&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;public&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="nf"&gt;mkdirSync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;out&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;recursive&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;width&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;height&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;src&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;metadata&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;width&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="nx"&gt;height&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`Source must be square (got &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;width&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;x&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;height&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;)`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;width&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="mi"&gt;512&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;warn&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`Warning: source is &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;width&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;px; 512px or larger gives sharper icons`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;png&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;size&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;file&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;src&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;resize&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;size&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;size&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;png&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;toFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;out&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;/&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;file&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;png&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;32&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;favicon-32.png&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;            &lt;span class="c1"&gt;// input for favicon.ico&lt;/span&gt;
&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;png&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;180&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;apple-touch-icon.png&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;     &lt;span class="c1"&gt;// iOS home screen&lt;/span&gt;
&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;png&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;192&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;icon-192.png&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;             &lt;span class="c1"&gt;// manifest&lt;/span&gt;
&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;png&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;512&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;icon-512.png&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;             &lt;span class="c1"&gt;// manifest&lt;/span&gt;

&lt;span class="c1"&gt;// Maskable: logo shrunk into the central 409x409 safe zone on a solid background&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;inner&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;src&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;resize&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;409&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;409&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;png&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;toBuffer&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;create&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;width&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;512&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;height&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;512&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;channels&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;background&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;#ffffff&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
  &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;composite&lt;/span&gt;&lt;span class="p"&gt;([{&lt;/span&gt; &lt;span class="na"&gt;input&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;inner&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;gravity&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;center&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;}])&lt;/span&gt;
  &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;png&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
  &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;out&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;/icon-mask.png`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Done: favicon-32.png, apple-touch-icon.png, icon-192.png, icon-512.png, icon-mask.png&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Then create the ICO with ImageMagick. This version packs three sizes into one file:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;convert logo.png &lt;span class="nt"&gt;-define&lt;/span&gt; icon:auto-resize&lt;span class="o"&gt;=&lt;/span&gt;48,32,16 public/favicon.ico
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Tested on a 1024×1024 source, the script produces all five PNGs at the right sizes, and the ImageMagick command creates an ICO containing 48, 32 and 16 pixel images. The script also stops with a clear error if the source image isn't square. Change the maskable background color to match your brand.&lt;/p&gt;

&lt;h3&gt;
  
  
  On Popular Platforms
&lt;/h3&gt;

&lt;p&gt;Most platforms handle part of this for you. WordPress has a Site Icon setting in the Customizer, Shopify themes include a favicon upload in theme settings, and frameworks such as Next.js support icon files placed in specific folders. Check what your platform generates before adding your own tags, so you don't end up with duplicates.&lt;/p&gt;

&lt;h2&gt;
  
  
  Google Search Favicon Rules
&lt;/h2&gt;

&lt;p&gt;To appear beside your result in Google Search, your favicon has to meet Google's guidelines:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Shape and size:&lt;/strong&gt; "Your favicon must be a square (1:1 aspect ratio) that's at least 8x8px," with larger than 48×48 recommended&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Format:&lt;/strong&gt; one of Google's supported formats, such as ICO or PNG&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Crawlable:&lt;/strong&gt; "Googlebot-Image must be able to crawl the favicon file," and it must not be blocked by robots.txt&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Stable:&lt;/strong&gt; "The favicon URL must be stable (don't change the URL frequently)"&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;One per site:&lt;/strong&gt; Google supports one favicon per hostname, declared on the home page&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Appropriate:&lt;/strong&gt; it should represent your brand. Google substitutes a default icon for inappropriate imagery&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Changes take time. Google says recrawling "can take several days to several weeks," and you can request indexing of your home page with the URL Inspection tool to speed things up. Even then, "A favicon isn't guaranteed to appear in Google Search results, even if all guidelines are met."&lt;/p&gt;

&lt;h2&gt;
  
  
  Testing and Caching
&lt;/h2&gt;

&lt;p&gt;After adding your favicon:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Open &lt;code&gt;/favicon.ico&lt;/code&gt; directly&lt;/strong&gt; in your browser to confirm it loads&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Check the Network tab&lt;/strong&gt; in developer tools for 404 errors on icon files&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Test in a private window,&lt;/strong&gt; because browsers cache favicons aggressively&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Add the site to a phone's home screen&lt;/strong&gt; to check the Apple touch icon and manifest icons&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;If you replace an icon and the old one keeps appearing, browser caching is usually the reason. A new filename forces browsers to fetch the new icon, but Google prefers a stable favicon URL, so change it only when you genuinely update the design.&lt;/p&gt;

&lt;h2&gt;
  
  
  Common Mistakes
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;A non-square source image,&lt;/strong&gt; which gets stretched or rejected&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Using &lt;code&gt;rel="shortcut icon"&lt;/code&gt;&lt;/strong&gt; instead of &lt;code&gt;rel="icon"&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Blocking icon files&lt;/strong&gt; in robots.txt, which stops Google from using them&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Changing the favicon URL often,&lt;/strong&gt; which slows Google's updates&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Adding the favicon only to some pages,&lt;/strong&gt; but not the home page&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A detailed logo&lt;/strong&gt; that turns into a blur at 16 pixels&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Skipping the Apple touch icon,&lt;/strong&gt; so iOS uses a screenshot or a generic icon instead&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Duplicate tags&lt;/strong&gt; from both a theme and a plugin, with different files&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  FAQs
&lt;/h2&gt;

&lt;h3&gt;
  
  
  What size should a favicon be?
&lt;/h3&gt;

&lt;p&gt;A modern setup uses a 32×32 &lt;code&gt;favicon.ico&lt;/code&gt;, a scalable SVG, a 180×180 Apple touch icon and 192×192 and 512×512 PNGs for Android and web apps. For Google Search, the favicon must be square and at least 8×8 pixels, and Google recommends larger than 48×48.&lt;/p&gt;

&lt;h3&gt;
  
  
  What is the best format for a favicon?
&lt;/h3&gt;

&lt;p&gt;Use a combination. An SVG gives sharp icons and dark mode support in modern browsers, an ICO provides a fallback for older browsers and automatic requests, and PNGs serve Apple and Android home screens. Google Search doesn't list SVG as supported, so always keep an ICO or PNG favicon declared too.&lt;/p&gt;

&lt;h3&gt;
  
  
  Do I still need a favicon.ico file?
&lt;/h3&gt;

&lt;p&gt;Yes, for compatibility. Browsers and tools often request &lt;code&gt;/favicon.ico&lt;/code&gt; automatically, and older browsers don't support SVG favicons. A single 32×32 ICO in your site's root folder, declared with &lt;code&gt;sizes="32x32"&lt;/code&gt;, covers these cases without much effort.&lt;/p&gt;

&lt;h3&gt;
  
  
  Why isn't my favicon showing in Google search results?
&lt;/h3&gt;

&lt;p&gt;Common causes include a non-square image, an unsupported format, a favicon blocked by robots.txt, a frequently changing URL, or a favicon declared only on inner pages. Google can also take several days to several weeks to recrawl, and it doesn't guarantee a favicon will appear even when guidelines are met.&lt;/p&gt;

&lt;h3&gt;
  
  
  How do I make a favicon for free?
&lt;/h3&gt;

&lt;p&gt;Upload a square logo to a free favicon generator, which creates the ICO, PNG sizes, Apple touch icon, manifest and HTML for you. Developers can also generate icons with free tools such as &lt;code&gt;sharp&lt;/code&gt; and ImageMagick. Either way, start with a simple, square image of at least 512×512 pixels.&lt;/p&gt;

&lt;h3&gt;
  
  
  Does a favicon affect SEO?
&lt;/h3&gt;

&lt;p&gt;Not directly. A favicon isn't a ranking factor, but Google shows favicons beside search results, so a clear, recognizable icon can make your result easier to spot and may help clicks. It also improves brand recognition in tabs, bookmarks and home screens.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrapping Up
&lt;/h2&gt;

&lt;p&gt;You don't need a dozen favicon sizes anymore. A 32×32 ICO, an SVG with dark mode, a 180×180 Apple touch icon and 192 and 512 pixel PNGs in a web manifest cover almost every browser and device. Follow Google's square, crawlable and stable rules, use &lt;code&gt;rel="icon"&lt;/code&gt; and test in a private window.&lt;/p&gt;

&lt;p&gt;The fastest way to get the core files is SEO Site Checker's &lt;a href="https://seositechecker.pro/favicon-generator" rel="noopener noreferrer"&gt;free favicon generator&lt;/a&gt;. Add your own SVG for dark mode, paste the HTML and you're done.&lt;/p&gt;

</description>
      <category>webdev</category>
      <category>html</category>
      <category>beginners</category>
      <category>seo</category>
    </item>
    <item>
      <title>Open Graph Previews Breaking on Social Shares: A Debugging Scenario</title>
      <dc:creator>Jay Barker</dc:creator>
      <pubDate>Sat, 07 Nov 2026 00:50:04 +0000</pubDate>
      <link>https://dev.to/jaybarker/open-graph-previews-breaking-on-social-shares-a-debugging-scenario-574i</link>
      <guid>https://dev.to/jaybarker/open-graph-previews-breaking-on-social-shares-a-debugging-scenario-574i</guid>
      <description>&lt;p&gt;Launch day. The blog post is live, the team is excited, and the marketing lead shares it everywhere at once. Then the messages start coming in.&lt;/p&gt;

&lt;p&gt;On LinkedIn, the post is a bare URL with no card at all. In Slack, the preview shows the generic homepage image instead of the new post's artwork. And on Facebook, the card shows last week's draft title, which nobody wanted the world to see.&lt;/p&gt;

&lt;p&gt;Three platforms, three different failures, one very public launch. If your Open Graph preview is not showing, or showing the wrong thing, the cause is almost never mysterious. Link previews are built by crawlers, not browsers, so the fix starts with seeing exactly what each crawler receives.&lt;/p&gt;

&lt;p&gt;This post walks through that launch-day scenario step by step: how link previews work, how to see the page as a crawler does, what to check in your tags and your social card image, how to clear each platform's cache, and a small Node script that tests all of it before you hit share.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Disclosure:&lt;/strong&gt; Jay Barker writes for SEO Site Checker, whose free tools are linked below. The debugging method and script work with any stack.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  How Link Previews Actually Work
&lt;/h2&gt;

&lt;p&gt;When someone pastes a URL into LinkedIn, Facebook, X, Slack or WhatsApp, the platform doesn't look at the page the way you do. Instead:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;The platform's crawler requests your URL, usually with its own user agent.&lt;/li&gt;
&lt;li&gt;It reads the HTML it receives, looking for &lt;code&gt;og:*&lt;/code&gt; and &lt;code&gt;twitter:*&lt;/code&gt; meta tags.&lt;/li&gt;
&lt;li&gt;It requests the image named in &lt;code&gt;og:image&lt;/code&gt; or &lt;code&gt;twitter:image&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;It builds the card and caches the result, often for days.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Three facts explain most broken previews. Crawlers usually don't run JavaScript. Each platform caches what it finds. And each has its own image rules.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://developers.facebook.com/docs/sharing/webmasters" rel="noopener noreferrer"&gt;Facebook's Open Graph guide for webmasters&lt;/a&gt; lists &lt;code&gt;og:url&lt;/code&gt;, &lt;code&gt;og:title&lt;/code&gt;, &lt;code&gt;og:description&lt;/code&gt; and &lt;code&gt;og:image&lt;/code&gt; as "the most basic meta tags that you should use for all content types," with &lt;code&gt;og:type&lt;/code&gt; recommended. If you need a refresher on what each tag means, our earlier meta tags guide for developers covers definitions. This post is about what happens when they break.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Scenario: Three Platforms, Three Failures
&lt;/h2&gt;

&lt;p&gt;Here's what the team saw:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;LinkedIn:&lt;/strong&gt; no card at all, just the URL&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Slack:&lt;/strong&gt; a card, but with the homepage image and generic site title&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Facebook:&lt;/strong&gt; the right image, but last week's draft title&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;It's tempting to assume one bug. In practice, it's often three separate causes that happened to surface on the same day. The way to find them is to work from the outside in: what the crawler receives, then the tags, then the image, then the cache.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 1: See What the Crawler Sees
&lt;/h2&gt;

&lt;p&gt;Start by requesting the page with each crawler's user agent and looking only at the meta tags:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Facebook&lt;/span&gt;
curl &lt;span class="nt"&gt;-sL&lt;/span&gt; &lt;span class="nt"&gt;-A&lt;/span&gt; &lt;span class="s2"&gt;"facebookexternalhit/1.1 (+http://www.facebook.com/externalhit_uatext.php)"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  https://example.com/launch-post | &lt;span class="nb"&gt;grep&lt;/span&gt; &lt;span class="nt"&gt;-iE&lt;/span&gt; &lt;span class="s1"&gt;'og:|twitter:'&lt;/span&gt;

&lt;span class="c"&gt;# LinkedIn (a commonly seen LinkedInBot user agent)&lt;/span&gt;
curl &lt;span class="nt"&gt;-sL&lt;/span&gt; &lt;span class="nt"&gt;-A&lt;/span&gt; &lt;span class="s2"&gt;"LinkedInBot/1.0 (compatible; Mozilla/5.0; +http://www.linkedin.com)"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  https://example.com/launch-post | &lt;span class="nb"&gt;grep&lt;/span&gt; &lt;span class="nt"&gt;-iE&lt;/span&gt; &lt;span class="s1"&gt;'og:|twitter:'&lt;/span&gt;

&lt;span class="c"&gt;# Check status codes and redirects for any of them&lt;/span&gt;
curl &lt;span class="nt"&gt;-sIL&lt;/span&gt; &lt;span class="nt"&gt;-A&lt;/span&gt; &lt;span class="s2"&gt;"Twitterbot/1.0"&lt;/span&gt; https://example.com/launch-post
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The Facebook user agent string comes from Facebook's own documentation. The others are common examples, so check each platform's current documentation if you need an exact match for firewall rules.&lt;/p&gt;

&lt;p&gt;Look for three things: whether the tags exist in the raw HTML at all, what status code each request returns, and whether you're being redirected somewhere unexpected, such as a login page or a bot challenge.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;What the team found:&lt;/strong&gt; the blog runs on a single-page React app, and the post's Open Graph tags were added in the browser after JavaScript loaded. The raw HTML that Slack's crawler received contained only the site-wide default tags. That explained Slack's homepage image.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 2: Check the Tags
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Client-Rendered Tags
&lt;/h3&gt;

&lt;p&gt;If tags are added by JavaScript in the browser, most social crawlers never see them. Single-page apps need the meta tags in the initial HTML response, through server-side rendering, static generation or prerendering. Most modern frameworks have a built-in way to set per-page metadata on the server. Use it, and confirm the result with &lt;code&gt;curl&lt;/code&gt;, not your browser's inspector, which shows the page after JavaScript runs.&lt;/p&gt;

&lt;h3&gt;
  
  
  Relative or Wrong URLs
&lt;/h3&gt;

&lt;p&gt;&lt;code&gt;og:image&lt;/code&gt; should be an absolute HTTPS URL, such as &lt;code&gt;https://example.com/images/launch-card.jpg&lt;/code&gt;, not &lt;code&gt;/images/launch-card.jpg&lt;/code&gt;. Crawlers fetch the image separately, and a relative path may not resolve. Check that &lt;code&gt;og:url&lt;/code&gt; matches the page's canonical URL too, or platforms may group shares under the wrong address.&lt;/p&gt;

&lt;h3&gt;
  
  
  Duplicates and Conflicts
&lt;/h3&gt;

&lt;p&gt;A very common WordPress problem: an SEO plugin and the theme both output Open Graph tags, so the page has two &lt;code&gt;og:title&lt;/code&gt; or &lt;code&gt;og:image&lt;/code&gt; tags. Platforms may pick the first one they find, which might be the old or generic value. View the source and make sure each tag appears once.&lt;/p&gt;

&lt;h3&gt;
  
  
  Missing Width and Height
&lt;/h3&gt;

&lt;p&gt;Facebook recommends specifying &lt;code&gt;og:image:width&lt;/code&gt; and &lt;code&gt;og:image:height&lt;/code&gt; "to ensure that the image loads properly the first time it's shared." Without them, the crawler may need to download and process the image before it can render the card, and the first share can appear without an image.&lt;/p&gt;

&lt;p&gt;If you'd rather not hand-write tags, a &lt;a href="https://seositechecker.pro/open-graph-generator" rel="noopener noreferrer"&gt;free Open Graph generator&lt;/a&gt; builds the core &lt;code&gt;og:&lt;/code&gt; tags from a simple form, ready to paste into your template.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 3: Check the Image Itself
&lt;/h2&gt;

&lt;p&gt;Even with perfect tags, the card fails if the crawler can't get a usable image.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Access.&lt;/strong&gt; The image must return a &lt;code&gt;200&lt;/code&gt; status to bots. Common blockers include hotlink protection, a CDN or firewall bot challenge, signed or expiring image URLs, images on a password-protected staging server, and &lt;code&gt;robots.txt&lt;/code&gt; rules that block the image path.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Format.&lt;/strong&gt; Facebook's documentation lists &lt;code&gt;image/jpeg&lt;/code&gt;, &lt;code&gt;image/gif&lt;/code&gt; and &lt;code&gt;image/png&lt;/code&gt; as accepted image types. &lt;a href="https://developer.x.com/en/docs/x-for-websites/cards/overview/summary-card-with-large-image" rel="noopener noreferrer"&gt;X's summary_large_image requirements&lt;/a&gt; accept JPG, PNG, WEBP and GIF, and state that "SVG is not supported." So a WebP card image might work on X but fail on Facebook, and an SVG fails almost everywhere.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Size and shape.&lt;/strong&gt; X's large image card supports "an aspect ratio of 2:1 with minimum dimensions of 300x157 or maximum of 4096x4096 pixels," and images "must be less than 5MB in size." Facebook's best practices recommend images "at least 1080 pixels in width for best display on high resolution devices." A safe default that works well across platforms is a &lt;strong&gt;1200×630 JPG or PNG under about 1 MB&lt;/strong&gt;. If your image is heavier, compress it before upload.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Content-Type.&lt;/strong&gt; The server should send a &lt;code&gt;Content-Type&lt;/code&gt; header that matches the file, such as &lt;code&gt;image/jpeg&lt;/code&gt; for a JPG. A misconfigured server that sends &lt;code&gt;text/html&lt;/code&gt; or &lt;code&gt;application/octet-stream&lt;/code&gt; can make platforms reject a valid image.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;What the team found:&lt;/strong&gt; LinkedIn's crawler was hitting the CDN's bot protection when it requested the image. Instead of a JPG, it received an HTML "checking your browser" page with a 403 status, so LinkedIn had no image to show and dropped the card entirely. Adding an allow rule for known social crawlers fixed it.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 4: Clear Each Platform's Cache
&lt;/h2&gt;

&lt;p&gt;Fixing the page doesn't fix shares that platforms have already cached.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Facebook:&lt;/strong&gt; paste the URL into the Sharing Debugger. Facebook says it "also triggers a scrape of your page," and you can click to scrape again after fixing errors. Note that Facebook says "Images are cached based on the URL and won't be updated unless the URL changes," so if you replace an image file, give it a new URL or add a version query string such as &lt;code&gt;launch-card.jpg?v=2&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;LinkedIn:&lt;/strong&gt; use LinkedIn's Post Inspector, which refetches the page and shows the preview LinkedIn will use.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;X, Slack, Discord and WhatsApp:&lt;/strong&gt; these refresh on their own schedules. If you need a fresh preview immediately, sharing a URL with a harmless query parameter, such as &lt;code&gt;?ref=launch&lt;/code&gt;, makes the platform treat it as a new link. Make sure your canonical tag still points to the clean URL.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;What the team found:&lt;/strong&gt; Facebook had scraped the post while it was still a draft with an old title. One click to scrape again in the Sharing Debugger fixed it.&lt;/p&gt;

&lt;h2&gt;
  
  
  A Script to Test Every Share Before Launch
&lt;/h2&gt;

&lt;p&gt;Running &lt;code&gt;curl&lt;/code&gt; by hand works, but it's easy to forget a platform. This Node script (Node 18 or later, no dependencies) fetches a page as Facebook, LinkedIn, X and Slack would, checks the core tags, then fetches the image as each crawler and checks status, type, file size and dimensions.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// og-check.mjs: fetch a page as social crawlers do and check its preview tags&lt;/span&gt;
&lt;span class="c1"&gt;// Usage: node og-check.mjs https://example.com/post   (Node 18+, no dependencies)&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;CRAWLERS&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="na"&gt;Facebook&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;facebookexternalhit/1.1 (+http://www.facebook.com/externalhit_uatext.php)&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="na"&gt;LinkedIn&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;LinkedInBot/1.0 (compatible; Mozilla/5.0; +http://www.linkedin.com)&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="na"&gt;X&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Twitterbot/1.0&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="na"&gt;Slack&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Slackbot-LinkExpanding 1.0 (+https://api.slack.com/robots)&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;};&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;REQUIRED&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;og:title&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;og:description&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;og:image&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;og:url&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;og:type&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;readMeta&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;html&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;tags&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{};&lt;/span&gt;
  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;tag&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;html&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;matchAll&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;/&amp;lt;meta&lt;/span&gt;&lt;span class="se"&gt;\b[^&lt;/span&gt;&lt;span class="sr"&gt;&amp;gt;&lt;/span&gt;&lt;span class="se"&gt;]&lt;/span&gt;&lt;span class="sr"&gt;*&amp;gt;/gi&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;key&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sr"&gt;/&lt;/span&gt;&lt;span class="se"&gt;(?:&lt;/span&gt;&lt;span class="sr"&gt;property|name&lt;/span&gt;&lt;span class="se"&gt;)&lt;/span&gt;&lt;span class="sr"&gt;=&lt;/span&gt;&lt;span class="se"&gt;[&lt;/span&gt;&lt;span class="sr"&gt;"'&lt;/span&gt;&lt;span class="se"&gt;]([^&lt;/span&gt;&lt;span class="sr"&gt;"'&lt;/span&gt;&lt;span class="se"&gt;]&lt;/span&gt;&lt;span class="sr"&gt;+&lt;/span&gt;&lt;span class="se"&gt;)[&lt;/span&gt;&lt;span class="sr"&gt;"'&lt;/span&gt;&lt;span class="se"&gt;]&lt;/span&gt;&lt;span class="sr"&gt;/i&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;exec&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;tag&lt;/span&gt;&lt;span class="p"&gt;)?.[&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;]?.&lt;/span&gt;&lt;span class="nf"&gt;toLowerCase&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;value&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sr"&gt;/content=&lt;/span&gt;&lt;span class="se"&gt;[&lt;/span&gt;&lt;span class="sr"&gt;"'&lt;/span&gt;&lt;span class="se"&gt;]([^&lt;/span&gt;&lt;span class="sr"&gt;"'&lt;/span&gt;&lt;span class="se"&gt;]&lt;/span&gt;&lt;span class="sr"&gt;*&lt;/span&gt;&lt;span class="se"&gt;)[&lt;/span&gt;&lt;span class="sr"&gt;"'&lt;/span&gt;&lt;span class="se"&gt;]&lt;/span&gt;&lt;span class="sr"&gt;/i&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;exec&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;tag&lt;/span&gt;&lt;span class="p"&gt;)?.[&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;key&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;value&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="kc"&gt;undefined&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;tags&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;key&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;||=&lt;/span&gt; &lt;span class="p"&gt;[]).&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;tags&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;imageSize&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mh"&gt;0x89&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mh"&gt;0x50&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;w&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;readUInt32BE&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;16&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt; &lt;span class="na"&gt;h&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;readUInt32BE&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;20&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;};&lt;/span&gt; &lt;span class="c1"&gt;// PNG&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mh"&gt;0xff&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mh"&gt;0xd8&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="c1"&gt;// JPEG: walk segments to the SOF marker&lt;/span&gt;
    &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;while &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="mi"&gt;9&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;marker&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt;
      &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;marker&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;=&lt;/span&gt; &lt;span class="mh"&gt;0xc0&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;marker&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;=&lt;/span&gt; &lt;span class="mh"&gt;0xc3&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;w&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;readUInt16BE&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mi"&gt;7&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt; &lt;span class="na"&gt;h&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;readUInt16BE&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mi"&gt;5&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;};&lt;/span&gt;
      &lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;readUInt16BE&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;checkImage&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;url&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;ua&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;res&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;url&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;User-Agent&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;ua&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt; &lt;span class="na"&gt;redirect&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;follow&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;type&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;content-type&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;unknown&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;ok&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`image returned HTTP &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;status&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="s2"&gt;`HTTP &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;status&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;buf&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;Buffer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;arrayBuffer&lt;/span&gt;&lt;span class="p"&gt;());&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;kb&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;1024&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;type&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;startsWith&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;image/&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`image Content-Type is &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;type&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;, not an image`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;type&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;includes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;svg&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;SVG images are not supported for social cards&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;type&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;includes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;webp&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;WebP works on X but not on Facebook (use JPG or PNG)&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;kb&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;5120&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`image is &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;kb&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; KB (X limit is 5 MB)`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;size&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;imageSize&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;type&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;, &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;kb&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; KB&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;size&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="s2"&gt;`, &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;size&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;w&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;x&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;size&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;h&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;''&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;url&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt;
&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;url&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Usage: node og-check.mjs &amp;lt;url&amp;gt;&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt; &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;exit&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;failures&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;ua&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nb"&gt;Object&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;entries&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;CRAWLERS&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[];&lt;/span&gt;
  &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;summary&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;''&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;try&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;res&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;url&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;User-Agent&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;ua&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt; &lt;span class="na"&gt;redirect&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;follow&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;ok&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`page returned HTTP &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;status&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;tags&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;readMeta&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;text&lt;/span&gt;&lt;span class="p"&gt;());&lt;/span&gt;
    &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;key&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;REQUIRED&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;tags&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;key&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`missing &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;key&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;key&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;values&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nb"&gt;Object&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;entries&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;tags&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;key&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;startsWith&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;og:&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;values&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;key&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;og:image&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`duplicate &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;key&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;tags&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;og:image&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]?.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;tags&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;og:image&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; og:image tags (first one usually wins)`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;image&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;tags&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;og:image&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]?.[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;image&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="sr"&gt;/^https:&lt;/span&gt;&lt;span class="se"&gt;\/\/&lt;/span&gt;&lt;span class="sr"&gt;/i&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;image&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`og:image is not an absolute HTTPS URL: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;image&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;image&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;tags&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;og:image:width&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;no og:image:width/height (first share may show no image)&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;image&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="sr"&gt;/^https&lt;/span&gt;&lt;span class="se"&gt;?&lt;/span&gt;&lt;span class="sr"&gt;:&lt;/span&gt;&lt;span class="se"&gt;\/\/&lt;/span&gt;&lt;span class="sr"&gt;/i&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;image&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="nx"&gt;summary&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;checkImage&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;image&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;ua&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;catch &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;err&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`request failed: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;err&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="nx"&gt;failures&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`\n&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;PROBLEMS&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;OK&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;}${&lt;/span&gt;&lt;span class="nx"&gt;summary&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="s2"&gt;`  (image: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;summary&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;)`&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;''&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;p&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`  - &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;p&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;exitCode&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;failures&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Run it against any public URL:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;node og-check.mjs https://example.com/launch-post
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Here's the output from a test server set up to reproduce the scenario, with a CDN rule that blocks LinkedIn's crawler from the image:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Facebook: OK  (image: image/png, 4 KB, 1200x630)

LinkedIn: PROBLEMS  (image: HTTP 403)
  - image returned HTTP 403

X: OK  (image: image/png, 4 KB, 1200x630)

Slack: OK  (image: image/png, 4 KB, 1200x630)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;And against a single-page app page whose real tags are added by JavaScript, the crawlers only see the defaults:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Facebook: PROBLEMS
  - missing og:description
  - missing og:url
  - missing og:type
  - og:image is not an absolute HTTPS URL: /default.png
  - no og:image:width/height (first share may show no image)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A clean page prints &lt;code&gt;OK&lt;/code&gt; for every crawler with the image type, size and dimensions, and exits with code &lt;code&gt;0&lt;/code&gt;. Any problem exits with code &lt;code&gt;1&lt;/code&gt;, so you can add the script to a pre-launch checklist or a CI job that runs against your staging or production URLs.&lt;/p&gt;

&lt;p&gt;The checks are deliberately simple. The script reads meta tags with regular expressions rather than a full HTML parser, and it reads dimensions only for PNG and JPEG files. Treat its output as a fast first pass, then confirm with each platform's own debugger before a big launch.&lt;/p&gt;

&lt;h2&gt;
  
  
  Prevention Checklist
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Meta tags are in the initial HTML, not added by JavaScript&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;og:image&lt;/code&gt; is an absolute HTTPS URL to a 1200×630 JPG or PNG, under about 1 MB&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;og:image:width&lt;/code&gt; and &lt;code&gt;og:image:height&lt;/code&gt; are set&lt;/li&gt;
&lt;li&gt;Each Open Graph tag appears only once, with no plugin conflicts&lt;/li&gt;
&lt;li&gt;Card images return &lt;code&gt;200&lt;/code&gt; to social crawlers, with no bot challenges or expiring URLs&lt;/li&gt;
&lt;li&gt;The server sends the correct &lt;code&gt;Content-Type&lt;/code&gt; for images&lt;/li&gt;
&lt;li&gt;The test script passes for every crawler before launch&lt;/li&gt;
&lt;li&gt;The URL has been scraped in Facebook's Sharing Debugger and LinkedIn's Post Inspector before you announce&lt;/li&gt;
&lt;li&gt;Image URLs get a new version whenever the image changes&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;For X, add &lt;code&gt;twitter:card&lt;/code&gt; tags as well. A &lt;a href="https://seositechecker.pro/twitter-card-generator" rel="noopener noreferrer"&gt;Twitter card generator&lt;/a&gt; creates them alongside your Open Graph tags. Afterwards, a &lt;a href="https://seositechecker.pro/website-seo-score-checker" rel="noopener noreferrer"&gt;website SEO checker&lt;/a&gt; gives you a broader view of the page's metadata and technical health.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQs
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Why is my Open Graph image not showing?
&lt;/h3&gt;

&lt;p&gt;The most common causes are tags added by JavaScript, so crawlers never see them, a relative or HTTP image URL, an image blocked by a firewall or hotlink protection, an unsupported format such as SVG, or a stale cached preview. Fetch the page and the image with a crawler's user agent to find out which.&lt;/p&gt;

&lt;h3&gt;
  
  
  Why does Facebook show an old image or title?
&lt;/h3&gt;

&lt;p&gt;Facebook caches previews. Paste the URL into the Sharing Debugger to trigger a new scrape. If you replaced the image file but kept the same URL, Facebook may keep the old image, because it caches images by URL. Give the new image a different URL or add a version parameter.&lt;/p&gt;

&lt;h3&gt;
  
  
  How do I refresh a LinkedIn link preview?
&lt;/h3&gt;

&lt;p&gt;Paste the URL into LinkedIn's Post Inspector, which refetches the page and shows the preview LinkedIn will use. If the preview is still wrong, check that LinkedIn's crawler can reach both the page and the image without being blocked or redirected.&lt;/p&gt;

&lt;h3&gt;
  
  
  What size should an Open Graph image be?
&lt;/h3&gt;

&lt;p&gt;A 1200×630 pixel JPG or PNG under about 1 MB works well across most platforms. X's large image card uses a 2:1 ratio, accepts images from 300×157 up to 4096×4096 and requires files under 5 MB. Facebook recommends images at least 1080 pixels wide.&lt;/p&gt;

&lt;h3&gt;
  
  
  Do social media crawlers run JavaScript?
&lt;/h3&gt;

&lt;p&gt;Generally, you shouldn't rely on it. Most link preview crawlers read the HTML your server returns, so tags added by client-side JavaScript are often missed. Render Open Graph tags on the server, through static generation or with prerendering, and verify them with &lt;code&gt;curl&lt;/code&gt;.&lt;/p&gt;

&lt;h3&gt;
  
  
  Why does my link preview work on Facebook but not on X or WhatsApp?
&lt;/h3&gt;

&lt;p&gt;Each platform has its own crawler, image rules and cache. X uses the &lt;code&gt;twitter:card&lt;/code&gt; tag to decide which card to show, so add it alongside your Open Graph tags. Image formats, sizes and firewall rules can affect one crawler but not another. Test the page with each platform's user agent.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrapping Up
&lt;/h2&gt;

&lt;p&gt;When an Open Graph preview is not showing, debug it in order. See what each crawler actually receives, check the tags, check the image, then clear each platform's cache. In our scenario, that meant server-rendering the tags for Slack, allowing social crawlers through the CDN for LinkedIn and rescraping the page on Facebook.&lt;/p&gt;

&lt;p&gt;To get the tags right from the start, try the &lt;a href="https://seositechecker.pro/open-graph-generator" rel="noopener noreferrer"&gt;free Open Graph generator&lt;/a&gt; from SEO Site Checker, then run the script before every launch.&lt;/p&gt;

</description>
      <category>webdev</category>
      <category>seo</category>
      <category>javascript</category>
      <category>debugging</category>
    </item>
    <item>
      <title>Compress Images Before You Upload: A Faster Website Workflow</title>
      <dc:creator>Jay Barker</dc:creator>
      <pubDate>Thu, 05 Nov 2026 23:05:44 +0000</pubDate>
      <link>https://dev.to/jaybarker/compress-images-before-you-upload-a-faster-website-workflow-4fb5</link>
      <guid>https://dev.to/jaybarker/compress-images-before-you-upload-a-faster-website-workflow-4fb5</guid>
      <description>&lt;p&gt;You run Lighthouse on a page you just shipped, and there it is again, right at the top of the report: "Properly size images." Underneath, a list of offenders, led by a 4.2 MB hero photo that someone exported straight from a camera and dropped into the CMS.&lt;/p&gt;

&lt;p&gt;Images are usually the heaviest thing on a web page, and they're often the Largest Contentful Paint element too, which means they directly affect how fast your page feels and how it scores in Core Web Vitals. The fix isn't complicated, but it does need a consistent workflow, because "remember to compress it" is not a process.&lt;/p&gt;

&lt;p&gt;So if you've been searching for how to compress images for a website properly, this is the workflow I use. It's six steps, a short script that does most of it in one command, and the HTML to serve the results the right way.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Disclosure:&lt;/strong&gt; Jay Barker writes for SEO Site Checker, whose image compressor is mentioned below. The rest of the workflow uses open-source tools.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  The Workflow in 60 Seconds
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Resize&lt;/strong&gt; to the largest size you actually display.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Choose the right format&lt;/strong&gt; for the job.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Compress&lt;/strong&gt; with sensible quality settings.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Strip metadata&lt;/strong&gt; you don't need.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Automate it,&lt;/strong&gt; so it happens every time.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Serve it properly&lt;/strong&gt; with &lt;code&gt;&amp;lt;picture&amp;gt;&lt;/code&gt;, &lt;code&gt;srcset&lt;/code&gt; and the right loading hints.&lt;/li&gt;
&lt;/ol&gt;

&lt;h2&gt;
  
  
  Why Compress Before Upload, Not After
&lt;/h2&gt;

&lt;p&gt;Most CMS platforms and plugins can optimize images after you upload them. That's better than nothing, but it has real downsides:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;The original still lands on your server.&lt;/strong&gt; It gets stored, backed up and sometimes served, depending on how the theme handles image sizes.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Big files bloat your Git repo forever.&lt;/strong&gt; If your images live in the repo, a 6 MB PNG committed once stays in your history permanently, even after you replace it.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;You give up control.&lt;/strong&gt; Automatic optimizers apply one-size-fits-all settings. Some are too aggressive and leave visible artifacts. Others barely touch the file.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Results are inconsistent.&lt;/strong&gt; Different people, different tools, different outcomes.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Compressing before upload means every image arrives at the right size, in the right format and at the right quality, whether it's going into a CMS, a static site or a Git repo.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 1: Resize to the Size You Actually Display
&lt;/h2&gt;

&lt;p&gt;Resizing is the biggest single win, and it's the step people skip most often. A modern phone photo is often 4,000 pixels wide. If it displays in an 800-pixel column, roughly 96% of those pixels are thrown away by the browser after being downloaded.&lt;/p&gt;

&lt;p&gt;A few rules of thumb:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Export at the width you display,&lt;/strong&gt; or up to 2x that width for important images on high-density screens.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cap hero images at around 1,600 to 2,000 pixels wide.&lt;/strong&gt; Larger rarely looks better, but it's always heavier.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Generate a few widths&lt;/strong&gt; (for example 480, 960 and 1600) so the browser can pick the right one with &lt;code&gt;srcset&lt;/code&gt;. More on that in Step 6.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The reason 2x isn't a free lunch is that file size grows with pixel count, not width. As &lt;a href="https://web.dev/articles/choose-the-right-image-format" rel="noopener noreferrer"&gt;web.dev's guide to choosing the right image format&lt;/a&gt; points out, doubling an image's resolution quadruples its pixels. So use 2x where it matters, not everywhere.&lt;/p&gt;

&lt;p&gt;With sharp, resizing is one line:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nx"&gt;sharp&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;sharp&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;photo.jpg&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;rotate&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;                 &lt;span class="c1"&gt;// apply EXIF orientation before metadata is removed&lt;/span&gt;
  &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;resize&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;width&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;1600&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;withoutEnlargement&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
  &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;photo-1600.jpg&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Step 2: Pick the Right Format
&lt;/h2&gt;

&lt;p&gt;Format choice matters almost as much as compression settings. Here's the short version:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Format&lt;/th&gt;
&lt;th&gt;Best for&lt;/th&gt;
&lt;th&gt;Notes&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;JPEG&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Photos&lt;/td&gt;
&lt;td&gt;Universal support. The safe fallback.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;PNG&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Screenshots, graphics with sharp edges, transparency&lt;/td&gt;
&lt;td&gt;Lossless, so files are large. Don't use it for photos.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;WebP&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Almost everything raster&lt;/td&gt;
&lt;td&gt;Smaller than JPEG and PNG, supports transparency.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;AVIF&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Photos and complex images&lt;/td&gt;
&lt;td&gt;Often smaller than WebP. Slower to encode.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;SVG&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Logos, icons, simple illustrations&lt;/td&gt;
&lt;td&gt;Vector, so sharp at any size and usually tiny.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;GIF&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Nothing, really&lt;/td&gt;
&lt;td&gt;Use a short video file for animation instead.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;WebP is the easy default today. &lt;a href="https://developers.google.com/speed/webp" rel="noopener noreferrer"&gt;Google's WebP documentation&lt;/a&gt; reports that lossy WebP images are 25 to 34% smaller than comparable JPEGs at equivalent quality, and lossless WebP images are 26% smaller than PNGs. It's supported in Chrome, Safari, Firefox, Edge and Opera.&lt;/p&gt;

&lt;p&gt;AVIF can go smaller still, and it's supported by current versions of all the major browsers. The trade-offs are slower encoding and, at very low quality settings, some color shifts. Serving AVIF with a WebP or JPEG fallback (Step 6) gives you the best of both.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 3: Compress With Sensible Settings
&lt;/h2&gt;

&lt;p&gt;First, a quick reality check on the phrase you'll see everywhere: "compress without losing quality." For PNG and lossless WebP, that's literally true. Lossless compression just stores the same pixels more efficiently.&lt;/p&gt;

&lt;p&gt;For JPEG, lossy WebP and AVIF, compression permanently discards some image data. There is &lt;em&gt;some&lt;/em&gt; quality loss. The goal is to make that loss invisible to the human eye while cutting the file size dramatically. That's very achievable with the right settings.&lt;/p&gt;

&lt;p&gt;Good starting points:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;JPEG:&lt;/strong&gt; quality 75 to 85. Use MozJPEG if your tool supports it, as it squeezes out extra savings.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;WebP:&lt;/strong&gt; quality 75 to 85.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;AVIF:&lt;/strong&gt; around 50 to 65. AVIF's quality scale isn't the same as JPEG's, so a lower number doesn't mean worse-looking.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Always compare the result against the original at 100% zoom, especially on faces, text and smooth gradients, which show artifacts first.&lt;/p&gt;

&lt;p&gt;For tools, pick whatever fits the situation:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;One-off images:&lt;/strong&gt; a &lt;a href="https://seositechecker.pro/image-compressor" rel="noopener noreferrer"&gt;free online image compressor&lt;/a&gt; handles PNG, JPEG and WebP files, up to 10 at a time without an account, with no settings to fiddle with. It can also convert the results to AVIF or WebP. It's handy when someone sends you a few images and you just need them smaller.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Visual comparison:&lt;/strong&gt; Squoosh, Google's browser-based app, shows the original and compressed versions side by side with a slider, which is great for finding the right quality level.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Scripting:&lt;/strong&gt; command-line tools work well in build scripts:
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# WebP at quality 80&lt;/span&gt;
cwebp &lt;span class="nt"&gt;-q&lt;/span&gt; 80 input.jpg &lt;span class="nt"&gt;-o&lt;/span&gt; output.webp

&lt;span class="c"&gt;# AVIF at quality 60&lt;/span&gt;
avifenc &lt;span class="nt"&gt;-q&lt;/span&gt; 60 input.jpg output.avif

&lt;span class="c"&gt;# Resize, strip metadata and recompress a JPEG with ImageMagick&lt;/span&gt;
magick input.jpg &lt;span class="nt"&gt;-resize&lt;/span&gt; 1600x &lt;span class="nt"&gt;-strip&lt;/span&gt; &lt;span class="nt"&gt;-quality&lt;/span&gt; 80 output.jpg
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;One gotcha: recompressing a JPEG that's already been compressed often saves little or nothing, and can even produce a bigger file. If a tool reports zero savings, it's usually because the image was already optimized. Always work from the original where you can.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 4: Strip Metadata
&lt;/h2&gt;

&lt;p&gt;Photos carry metadata, known as EXIF data: camera model, lens settings, timestamps and, very often on phones, &lt;strong&gt;GPS coordinates&lt;/strong&gt;. Publishing a photo taken at someone's home can publish where they live. Stripping metadata removes that risk and shaves off some bytes.&lt;/p&gt;

&lt;p&gt;Two things to keep in mind. First, keep or convert the color profile, ideally to sRGB, so colors look the same in every browser. Second, apply the EXIF orientation &lt;em&gt;before&lt;/em&gt; stripping, or portrait photos can suddenly appear sideways. sharp removes metadata by default, and its &lt;code&gt;.rotate()&lt;/code&gt; method (with no arguments) applies the orientation first, which is why it appears in every example here.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 5: Automate It With a Pre-Upload Script
&lt;/h2&gt;

&lt;p&gt;Doing all of this by hand works for one image. For a whole site, put it in a script. Here's the one I use. It takes a folder of original JPEG and PNG files and, for each one, writes several widths in AVIF, WebP and JPEG, with metadata stripped, then prints a before-and-after report.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// scripts/optimize-images.mjs&lt;/span&gt;
&lt;span class="c1"&gt;// Usage: npm install sharp &amp;amp;&amp;amp; node scripts/optimize-images.mjs&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nx"&gt;sharp&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;sharp&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;readdir&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;mkdir&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;stat&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;node:fs/promises&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nx"&gt;path&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;node:path&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;SRC&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;images-src&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;       &lt;span class="c1"&gt;// put your original images here&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;OUT&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;public/images&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;    &lt;span class="c1"&gt;// optimized images go here&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;WIDTHS&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;480&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;960&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1600&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt;

&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;mkdir&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;OUT&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;recursive&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;files&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;readdir&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;SRC&lt;/span&gt;&lt;span class="p"&gt;)).&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;f&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="sr"&gt;/&lt;/span&gt;&lt;span class="se"&gt;\.(&lt;/span&gt;&lt;span class="sr"&gt;jpe&lt;/span&gt;&lt;span class="se"&gt;?&lt;/span&gt;&lt;span class="sr"&gt;g|png&lt;/span&gt;&lt;span class="se"&gt;)&lt;/span&gt;&lt;span class="sr"&gt;$/i&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;f&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;

&lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;file&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;files&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;input&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;path&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;SRC&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;file&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;path&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;parse&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;file&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;size&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;originalBytes&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;stat&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;input&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;width&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;originalWidth&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;input&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;metadata&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;

  &lt;span class="c1"&gt;// Never upscale: keep only widths the original can support&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;widths&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;WIDTHS&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;w&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;w&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;=&lt;/span&gt; &lt;span class="nx"&gt;originalWidth&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;widths&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;widths&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;originalWidth&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

  &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;largestWebp&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;width&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;widths&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;base&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;input&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;rotate&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;resize&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="nx"&gt;width&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt;

    &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;base&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;clone&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;avif&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;quality&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;55&lt;/span&gt; &lt;span class="p"&gt;}).&lt;/span&gt;&lt;span class="nf"&gt;toFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;path&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;OUT&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;-&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;width&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;.avif`&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;webp&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;base&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;clone&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;webp&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;quality&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;80&lt;/span&gt; &lt;span class="p"&gt;}).&lt;/span&gt;&lt;span class="nf"&gt;toFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;path&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;OUT&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;-&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;width&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;.webp`&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
    &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;base&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;clone&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;jpeg&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;quality&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;80&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;mozjpeg&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;}).&lt;/span&gt;&lt;span class="nf"&gt;toFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;path&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;OUT&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;-&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;width&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;.jpg`&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;

    &lt;span class="nx"&gt;largestWebp&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;max&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;largestWebp&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;webp&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;size&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;kb&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;bytes&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${(&lt;/span&gt;&lt;span class="nx"&gt;bytes&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;1024&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;toFixed&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt; KB`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;file&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nf"&gt;kb&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;originalBytes&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt; original, largest WebP &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nf"&gt;kb&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;largestWebp&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Add it to your &lt;code&gt;package.json&lt;/code&gt; so anyone on the team can run it:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"scripts"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"images"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"node scripts/optimize-images.mjs"&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;To stop oversized images from sneaking back in, add a size budget check to CI or a pre-commit hook. This one (Node 20 or newer) fails if any image in the output folder is over 300 KB:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// scripts/check-image-budget.mjs&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;readdir&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;stat&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;node:fs/promises&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nx"&gt;path&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;node:path&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;DIR&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;public/images&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;BUDGET_KB&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;300&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;failed&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;file&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;readdir&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;DIR&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;recursive&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;}))&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="sr"&gt;/&lt;/span&gt;&lt;span class="se"&gt;\.(&lt;/span&gt;&lt;span class="sr"&gt;avif|webp|jpe&lt;/span&gt;&lt;span class="se"&gt;?&lt;/span&gt;&lt;span class="sr"&gt;g|png|gif&lt;/span&gt;&lt;span class="se"&gt;)&lt;/span&gt;&lt;span class="sr"&gt;$/i&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;file&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="k"&gt;continue&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;size&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;stat&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;path&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;DIR&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;file&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;size&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;BUDGET_KB&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mi"&gt;1024&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;file&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; is &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;size&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;1024&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt; KB (budget: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;BUDGET_KB&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; KB)`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="nx"&gt;failed&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;exit&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;failed&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The budget number is a guideline, not a law. A full-width hero image might reasonably sit at 200 to 300 KB, while thumbnails should be a fraction of that. Adjust it to your site. The &lt;a href="https://sharp.pixelplumbing.com/" rel="noopener noreferrer"&gt;sharp documentation&lt;/a&gt; covers every option if you want to tune the output further.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 6: Serve Images Properly
&lt;/h2&gt;

&lt;p&gt;Compression gets you halfway. The other half is making sure the browser downloads the right file at the right time. Here's a hero image using the files the script produced:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;picture&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;source&lt;/span&gt; &lt;span class="na"&gt;type=&lt;/span&gt;&lt;span class="s"&gt;"image/avif"&lt;/span&gt;
    &lt;span class="na"&gt;srcset=&lt;/span&gt;&lt;span class="s"&gt;"/images/hero-480.avif 480w, /images/hero-960.avif 960w, /images/hero-1600.avif 1600w"&lt;/span&gt;
    &lt;span class="na"&gt;sizes=&lt;/span&gt;&lt;span class="s"&gt;"(max-width: 1000px) 100vw, 1000px"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;source&lt;/span&gt; &lt;span class="na"&gt;type=&lt;/span&gt;&lt;span class="s"&gt;"image/webp"&lt;/span&gt;
    &lt;span class="na"&gt;srcset=&lt;/span&gt;&lt;span class="s"&gt;"/images/hero-480.webp 480w, /images/hero-960.webp 960w, /images/hero-1600.webp 1600w"&lt;/span&gt;
    &lt;span class="na"&gt;sizes=&lt;/span&gt;&lt;span class="s"&gt;"(max-width: 1000px) 100vw, 1000px"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;img&lt;/span&gt; &lt;span class="na"&gt;src=&lt;/span&gt;&lt;span class="s"&gt;"/images/hero-960.jpg"&lt;/span&gt;
    &lt;span class="na"&gt;srcset=&lt;/span&gt;&lt;span class="s"&gt;"/images/hero-480.jpg 480w, /images/hero-960.jpg 960w, /images/hero-1600.jpg 1600w"&lt;/span&gt;
    &lt;span class="na"&gt;sizes=&lt;/span&gt;&lt;span class="s"&gt;"(max-width: 1000px) 100vw, 1000px"&lt;/span&gt;
    &lt;span class="na"&gt;width=&lt;/span&gt;&lt;span class="s"&gt;"1600"&lt;/span&gt; &lt;span class="na"&gt;height=&lt;/span&gt;&lt;span class="s"&gt;"900"&lt;/span&gt;
    &lt;span class="na"&gt;alt=&lt;/span&gt;&lt;span class="s"&gt;"Team reviewing a website design on a large monitor"&lt;/span&gt;
    &lt;span class="na"&gt;fetchpriority=&lt;/span&gt;&lt;span class="s"&gt;"high"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;/picture&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A few details make a big difference:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;The browser picks the first format it supports,&lt;/strong&gt; so list AVIF, then WebP, with JPEG as the fallback in the &lt;code&gt;&amp;lt;img&amp;gt;&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;srcset&lt;/code&gt; and &lt;code&gt;sizes&lt;/code&gt; let the browser choose the right width&lt;/strong&gt; for the screen, so phones don't download desktop-sized images.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Always set &lt;code&gt;width&lt;/code&gt; and &lt;code&gt;height&lt;/code&gt;.&lt;/strong&gt; The browser uses them to reserve space before the image loads, which prevents layout shift (CLS).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Don't lazy-load the hero image.&lt;/strong&gt; It's usually your LCP element, so it should load immediately, and &lt;code&gt;fetchpriority="high"&lt;/code&gt; tells the browser to prioritize it.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Do lazy-load images further down the page&lt;/strong&gt; with &lt;code&gt;loading="lazy"&lt;/code&gt; and &lt;code&gt;decoding="async"&lt;/code&gt;:
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;img&lt;/span&gt; &lt;span class="na"&gt;src=&lt;/span&gt;&lt;span class="s"&gt;"/images/gallery-960.webp"&lt;/span&gt; &lt;span class="na"&gt;width=&lt;/span&gt;&lt;span class="s"&gt;"960"&lt;/span&gt; &lt;span class="na"&gt;height=&lt;/span&gt;&lt;span class="s"&gt;"640"&lt;/span&gt;
  &lt;span class="na"&gt;alt=&lt;/span&gt;&lt;span class="s"&gt;"Finished kitchen renovation with oak cabinets"&lt;/span&gt;
  &lt;span class="na"&gt;loading=&lt;/span&gt;&lt;span class="s"&gt;"lazy"&lt;/span&gt; &lt;span class="na"&gt;decoding=&lt;/span&gt;&lt;span class="s"&gt;"async"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Framework and Platform Shortcuts
&lt;/h2&gt;

&lt;p&gt;If you're on a modern framework, some of this is built in. Next.js's &lt;code&gt;&amp;lt;Image&amp;gt;&lt;/code&gt; component and Astro's &lt;code&gt;&amp;lt;Image /&amp;gt;&lt;/code&gt; both resize, convert formats and add &lt;code&gt;srcset&lt;/code&gt; automatically. Image CDNs can transform images on the fly through URL parameters.&lt;/p&gt;

&lt;p&gt;They're great, and you should use them. But it's still worth compressing your source files first. Smaller sources mean a lighter repository, faster builds and less work at request time.&lt;/p&gt;

&lt;h2&gt;
  
  
  A Simple Version for Content Editors
&lt;/h2&gt;

&lt;p&gt;Scripts are great for developers, but on most teams, the people uploading images are marketers, writers and clients working in a CMS. If that's your situation, give them a simpler version of the workflow. Here's a checklist you can paste into your team's docs on how to compress images for a website before uploading:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Resize first.&lt;/strong&gt; Crop and resize the image to roughly the width it will appear on the page. For a blog post body, around 1,200 to 1,600 pixels wide is usually plenty. Most laptops have a built-in tool for this, such as Preview on a Mac or Photos on Windows.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Compress it.&lt;/strong&gt; Run it through an online compressor, and check the result looks right before you upload.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Use a sensible file name.&lt;/strong&gt; Rename &lt;code&gt;IMG_4823.jpg&lt;/code&gt; to something descriptive, like &lt;code&gt;oak-kitchen-cabinets.jpg&lt;/code&gt;. It helps image search and keeps the media library tidy.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Write alt text in the CMS.&lt;/strong&gt; Describe what the image shows, in a short sentence, for people using screen readers.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Never upload straight from a phone or camera.&lt;/strong&gt; Those files are almost always far bigger than a website needs.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;It takes an extra minute per image, and it prevents the 4 MB hero photo problem entirely. If you can, back it up with the size budget check from Step 5, so anything that slips through gets caught before it goes live.&lt;/p&gt;

&lt;h2&gt;
  
  
  How to Check Your Results
&lt;/h2&gt;

&lt;p&gt;After deploying, verify it worked:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Lighthouse and PageSpeed Insights&lt;/strong&gt; flag image problems directly. Look for "Properly size images," "Serve images in next-gen formats" and "Efficiently encode images."&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The DevTools Network panel&lt;/strong&gt; shows exactly what's downloaded. Filter by "Img," sort by size and check which format and width each image actually served.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A site-wide check&lt;/strong&gt; catches oversized images on pages you haven't looked at in a while. A quick &lt;a href="https://seositechecker.pro/website-seo-score-checker" rel="noopener noreferrer"&gt;site-wide SEO audit&lt;/a&gt; flags heavy images alongside other performance and SEO issues.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Common Mistakes
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Recompressing the same JPEG over and over instead of working from the original.&lt;/li&gt;
&lt;li&gt;Lazy-loading the hero image, which delays LCP.&lt;/li&gt;
&lt;li&gt;Using PNG for photos.&lt;/li&gt;
&lt;li&gt;Leaving out &lt;code&gt;width&lt;/code&gt; and &lt;code&gt;height&lt;/code&gt;, which causes layout shift.&lt;/li&gt;
&lt;li&gt;Shrinking giant images with CSS instead of resizing the file.&lt;/li&gt;
&lt;li&gt;Serving AVIF or WebP with no fallback for older clients.&lt;/li&gt;
&lt;li&gt;Exporting every screenshot at full Retina resolution, even thumbnails.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  FAQs
&lt;/h2&gt;

&lt;h3&gt;
  
  
  How do I compress images without losing quality?
&lt;/h3&gt;

&lt;p&gt;Use lossless compression (PNG or lossless WebP) when the image must be pixel-perfect. For photos, use lossy JPEG, WebP or AVIF at moderate quality settings, around 75 to 85 for JPEG and WebP. Some data is discarded, but at those settings the difference is usually invisible.&lt;/p&gt;

&lt;h3&gt;
  
  
  What is the best image format for websites?
&lt;/h3&gt;

&lt;p&gt;For most photos and graphics, WebP is the best all-round choice, with AVIF as an even smaller option where you can provide a fallback. Use SVG for logos and icons, JPEG as a universal fallback, and PNG only when you need lossless quality or transparency.&lt;/p&gt;

&lt;h3&gt;
  
  
  What file size should website images be?
&lt;/h3&gt;

&lt;p&gt;There's no single rule, but as a guideline, aim for most content images to be under 100 to 200 KB and large hero images under about 300 KB. Thumbnails should be far smaller. Resizing to the displayed dimensions usually does more than compression alone.&lt;/p&gt;

&lt;h3&gt;
  
  
  What dimensions should images be for a website?
&lt;/h3&gt;

&lt;p&gt;Match the largest size the image will actually display, and go up to 2x for important images on high-density screens. For full-width hero images, around 1,600 to 2,000 pixels wide is plenty. Generate several widths and let &lt;code&gt;srcset&lt;/code&gt; serve the right one.&lt;/p&gt;

&lt;h3&gt;
  
  
  Does compressing images help SEO?
&lt;/h3&gt;

&lt;p&gt;Indirectly, yes. Smaller images make pages load faster, which improves user experience and Core Web Vitals, especially Largest Contentful Paint. Google uses page experience as one of many signals. Descriptive file names and alt text also help your images appear in image search.&lt;/p&gt;

&lt;h3&gt;
  
  
  What's the difference between lossy and lossless compression?
&lt;/h3&gt;

&lt;p&gt;Lossless compression stores exactly the same pixels more efficiently, so there's no quality loss, but savings are smaller. Lossy compression permanently discards some data, producing much smaller files. At sensible settings, lossy compression is usually indistinguishable from the original to the human eye.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrapping Up
&lt;/h2&gt;

&lt;p&gt;Resize first, pick the right format, compress with sensible settings, strip the metadata, then serve the result with &lt;code&gt;&amp;lt;picture&amp;gt;&lt;/code&gt;, &lt;code&gt;srcset&lt;/code&gt; and proper loading hints. Put the whole thing in a script and a CI check, and "properly size images" disappears from your Lighthouse reports for good. For anything outside that workflow, there's a collection of &lt;a href="https://seositechecker.pro/tools" rel="noopener noreferrer"&gt;other free web tools&lt;/a&gt; for quick one-off jobs.&lt;/p&gt;

</description>
      <category>webdev</category>
      <category>performance</category>
      <category>tutorial</category>
      <category>beginners</category>
    </item>
    <item>
      <title>Book Formatting Mistakes That Get Ebooks Rejected</title>
      <dc:creator>Jay Barker</dc:creator>
      <pubDate>Wed, 04 Nov 2026 22:49:03 +0000</pubDate>
      <link>https://dev.to/jaybarker/book-formatting-mistakes-that-get-ebooks-rejected-1lna</link>
      <guid>https://dev.to/jaybarker/book-formatting-mistakes-that-get-ebooks-rejected-1lna</guid>
      <description>&lt;p&gt;The upload went through. The preview looked fine. Then, three days later, an email arrives: your Kindle book has a quality issue and needs corrections. Or Apple Books bounces your EPUB with a validation error that reads like a compiler message.&lt;/p&gt;

&lt;p&gt;Most ebook rejections come from a short, predictable list of formatting mistakes. They usually start in the source document, a Word file or a print layout that was never built for a screen, and they show up when a retailer converts, validates or reviews the file.&lt;/p&gt;

&lt;p&gt;This post covers 12 common ebook formatting mistakes, what each one triggers at the retailer, how to fix it at the source and how to check for it. It finishes with an ebook validation workflow, including EPUBCheck and a small Node script that scans an EPUB for the most common problems before you upload.&lt;/p&gt;

&lt;h2&gt;
  
  
  How Ebooks Get Rejected (Not Always at Upload)
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Upload or Conversion Failure
&lt;/h3&gt;

&lt;p&gt;The first gate is the file itself. On KDP, reflowable ebooks must be EPUB, DOCX or KPF. According to &lt;a href="https://kdp.amazon.com/en_US/help/topic/GULSQMHU5MNH4EZM" rel="noopener noreferrer"&gt;KDP's MOBI FAQ&lt;/a&gt;, Amazon stopped accepting MOBI files for reflowable books on August 1, 2021, and for fixed-layout books on March 18, 2025. Old tutorials that tell you to upload a MOBI will lead straight to an error.&lt;/p&gt;

&lt;h3&gt;
  
  
  Quality Review After Publishing
&lt;/h3&gt;

&lt;p&gt;The second gate catches many authors by surprise. A book can be live and still be flagged later. &lt;a href="https://kdp.amazon.com/en_US/help/topic/G200952510" rel="noopener noreferrer"&gt;KDP's Guide to Kindle Content Quality&lt;/a&gt; sorts problems by severity. It says "any Critical Issue will result in the book being removed from sale until corrections are made." Moderate distracting issues can leave the book on sale but add a temporary quality warning to its product page, which hurts sales almost as much.&lt;/p&gt;

&lt;p&gt;KDP also notes that "Typos are among the most common quality issues customers report," and many of the examples it lists are really formatting mistakes.&lt;/p&gt;

&lt;h3&gt;
  
  
  Validation at Other Retailers
&lt;/h3&gt;

&lt;p&gt;Apple Books, Kobo and most distributors check EPUB files against a standard. &lt;a href="https://w3c.github.io/epubcheck/about/" rel="noopener noreferrer"&gt;EPUBCheck, the official EPUB validator&lt;/a&gt;, is maintained by the W3C and describes itself as "the official conformance checker for EPUB publications." Its own documentation puts the stakes plainly: "Most retailers will not accept an EPUB file unless it successfully passes EPUBCheck scrutiny."&lt;/p&gt;

&lt;h2&gt;
  
  
  Reflowable vs Fixed Layout: The Root of Many Mistakes
&lt;/h2&gt;

&lt;p&gt;A print book has fixed pages. A reflowable ebook doesn't. Readers change the font, the text size, the margins and the background color, and the text reflows to fit a phone, a tablet or an e-reader. There are no page numbers, no fixed line breaks and no guarantee that two things will appear on the same screen.&lt;/p&gt;

&lt;p&gt;Most ebook formatting mistakes come from treating an ebook like a print PDF. Indents made with spaces, page numbers in the text, black text forced onto the page and pictures of tables all assume a fixed page that doesn't exist.&lt;/p&gt;

&lt;p&gt;Fixed-layout ebooks are the exception, used for picture books, cookbooks and heavily designed books where position matters. They follow their own rules and are best handled by someone experienced with them. Everything below is about reflowable ebooks, which cover most novels and nonfiction. If you're starting from scratch, this guide on &lt;a href="https://westernreflectionspublishing.com/blogs/how-to-format-a-book-for-self-publishing/" rel="noopener noreferrer"&gt;how to format a book for self-publishing&lt;/a&gt; covers the basics of setting up a clean manuscript.&lt;/p&gt;

&lt;h2&gt;
  
  
  The 12 Ebook Formatting Mistakes
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Layout and Spacing
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;1. Inline page numbers, headers and footers.&lt;/strong&gt; These creep in when a print PDF or a print-formatted Word file is converted. On screen, a stray "27" appears in the middle of a paragraph. KDP's quality guide says inline page numbers "must be removed." &lt;strong&gt;Fix:&lt;/strong&gt; start from a manuscript without print headers and footers, or remove them before converting. &lt;strong&gt;Check:&lt;/strong&gt; search the text for lines containing only a number.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;2. Tabs and spaces for indents, blank lines for spacing.&lt;/strong&gt; Pressing Tab or the space bar to indent, or Enter twice between paragraphs, produces uneven spacing after conversion. The indents vary by device and blank lines pile up at screen breaks. &lt;strong&gt;Fix:&lt;/strong&gt; use a paragraph style with a first-line indent and spacing set in the style. &lt;strong&gt;Check:&lt;/strong&gt; turn on hidden formatting marks in Word, or run the script below.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;3. Manual page breaks made with Enter.&lt;/strong&gt; Hitting Enter 20 times to start a new chapter creates blank screens on some devices and odd gaps on others. &lt;strong&gt;Fix:&lt;/strong&gt; use a real page break or a chapter heading style that starts on a new page. &lt;strong&gt;Check:&lt;/strong&gt; preview at several text sizes.&lt;/p&gt;

&lt;h3&gt;
  
  
  Text and Fonts
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;4. Forced font colors, sizes and alignment.&lt;/strong&gt; Text set to black looks fine on white, until a reader switches to dark mode and the words disappear. KDP specifically flags "Forced white text or forced black background that causes text to be unreadable," along with forced alignment and forced body text size. &lt;strong&gt;Fix:&lt;/strong&gt; leave body text on "Automatic" color and default size, and let the reading system handle it. &lt;strong&gt;Check:&lt;/strong&gt; preview in dark mode.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;5. Unsupported and junk characters.&lt;/strong&gt; Symbol fonts, unusual Unicode characters and leftover soft hyphens show up as boxes, question marks or broken words. KDP lists jumbled text and soft hyphens among its quality issues. &lt;strong&gt;Fix:&lt;/strong&gt; use standard characters and UTF-8 encoding, and replace decorative symbols with images or plain text. &lt;strong&gt;Check:&lt;/strong&gt; page through the book in Kindle Previewer.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;6. Embedded fonts used carelessly.&lt;/strong&gt; Embedding fonts can trigger validation warnings, increase file size and break reader font choices. Font licenses also vary, and some don't allow ebook embedding. &lt;strong&gt;Fix:&lt;/strong&gt; keep body text in the default font, and embed only licensed fonts for headings if you need them.&lt;/p&gt;

&lt;h3&gt;
  
  
  Structure and Navigation
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;7. No real heading styles.&lt;/strong&gt; Chapters typed in bold, large text look like headings but aren't. Without proper heading styles, conversion tools can't build the navigation readers use to jump between chapters. &lt;strong&gt;Fix:&lt;/strong&gt; apply Heading 1 to every chapter title and use heading styles consistently.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;8. A missing or broken table of contents.&lt;/strong&gt; Readers expect a working table of contents, and KDP lists "A link in the Table of Contents (TOC) that does not work" as a quality issue. EPUBCheck also reports links pointing to files or anchors that don't exist. &lt;strong&gt;Fix:&lt;/strong&gt; generate the TOC from heading styles rather than typing it, then click every entry in the preview.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;9. Broken or problem external links.&lt;/strong&gt; Links to dead pages, or links to prohibited sites, can be flagged. &lt;strong&gt;Fix:&lt;/strong&gt; test every URL before upload, keep links to a minimum and avoid linking readers to competing stores.&lt;/p&gt;

&lt;h3&gt;
  
  
  Images and Tables
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;10. Blurry images and images with small text.&lt;/strong&gt; Low-resolution images look worse on high-resolution screens, and text inside an image can't be resized. KDP flags "blurry images and images with illegible text." &lt;strong&gt;Fix:&lt;/strong&gt; use sharp images at a suitable resolution, and never put body text, charts with tiny labels or tables inside an image.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;11. Wide tables.&lt;/strong&gt; A table that fits a printed page can be cut off on a phone at the default font size, which KDP lists as a quality issue. It also flags tables used for layout rather than data. &lt;strong&gt;Fix:&lt;/strong&gt; simplify wide tables, split them or turn them into lists. &lt;strong&gt;Check:&lt;/strong&gt; preview on the smallest phone size.&lt;/p&gt;

&lt;h3&gt;
  
  
  Content and Metadata
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;12. Metadata that doesn't match the file, and duplicated or missing content.&lt;/strong&gt; A subtitle in the listing that doesn't appear in the book, a chapter pasted twice, missing images or an old draft uploaded by mistake all count as quality issues. KDP removes books with the wrong content from sale. &lt;strong&gt;Fix:&lt;/strong&gt; check the title page against your listing, and open the exact file you uploaded, not the one on your desktop.&lt;/p&gt;

&lt;h2&gt;
  
  
  Validate Before You Upload
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Run EPUBCheck
&lt;/h3&gt;

&lt;p&gt;EPUBCheck runs on Java and works from the command line:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;java &lt;span class="nt"&gt;-jar&lt;/span&gt; epubcheck.jar mybook.epub
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The output lists each problem as an ERROR or a WARNING, with the file and line inside the EPUB. Errors usually mean rejection at retailers that validate. Warnings are worth reviewing but often aren't fatal. Fix problems in your source document and export again where you can, rather than patching the EPUB by hand, so the fix survives the next revision.&lt;/p&gt;

&lt;h3&gt;
  
  
  Preview in Kindle Previewer
&lt;/h3&gt;

&lt;p&gt;Amazon's free &lt;a href="https://kdp.amazon.com/en_US/help/topic/G202131170" rel="noopener noreferrer"&gt;Kindle Previewer&lt;/a&gt; shows how the book will look on Kindle e-readers, phones and tablets, in different orientations and fonts. Click every TOC entry, flip through every chapter and turn on dark mode. Previewer shows you how the book looks rather than grading it, so you still have to do the looking.&lt;/p&gt;

&lt;h3&gt;
  
  
  A Tiny Lint Script
&lt;/h3&gt;

&lt;p&gt;EPUBCheck confirms the file is valid. It won't tell you that you indented with spaces or forced black text, because those are valid HTML. This small Node script catches those mistakes. It needs no dependencies and reads an unzipped EPUB folder:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// lint-epub.js: flag common ebook formatting mistakes in an unzipped EPUB&lt;/span&gt;
&lt;span class="c1"&gt;// Usage: unzip mybook.epub -d mybook &amp;amp;&amp;amp; node lint-epub.js mybook&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;fs&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;require&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;fs&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;path&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;require&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;path&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;checks&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Empty paragraph (blank line used for spacing)&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;re&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sr"&gt;/&amp;lt;p&lt;/span&gt;&lt;span class="se"&gt;[^&lt;/span&gt;&lt;span class="sr"&gt;&amp;gt;&lt;/span&gt;&lt;span class="se"&gt;]&lt;/span&gt;&lt;span class="sr"&gt;*&amp;gt;&lt;/span&gt;&lt;span class="se"&gt;\s&lt;/span&gt;&lt;span class="sr"&gt;*&lt;/span&gt;&lt;span class="se"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;&amp;amp;nbsp;|&amp;amp;#160;|&amp;nbsp;&lt;/span&gt;&lt;span class="se"&gt;)?\s&lt;/span&gt;&lt;span class="sr"&gt;*&amp;lt;&lt;/span&gt;&lt;span class="se"&gt;\/&lt;/span&gt;&lt;span class="sr"&gt;p&amp;gt;/gi&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Run of non-breaking spaces (manual indent)&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;re&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sr"&gt;/&lt;/span&gt;&lt;span class="se"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;&amp;amp;nbsp;|&amp;amp;#160;|&amp;nbsp;&lt;/span&gt;&lt;span class="se"&gt;){2,}&lt;/span&gt;&lt;span class="sr"&gt;/gi&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Tab character&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;re&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sr"&gt;/&lt;/span&gt;&lt;span class="se"&gt;\t&lt;/span&gt;&lt;span class="sr"&gt;/g&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Forced text color (inline style)&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;re&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sr"&gt;/style="&lt;/span&gt;&lt;span class="se"&gt;[^&lt;/span&gt;&lt;span class="sr"&gt;"&lt;/span&gt;&lt;span class="se"&gt;]&lt;/span&gt;&lt;span class="sr"&gt;*&lt;/span&gt;&lt;span class="se"&gt;(?&amp;lt;&lt;/span&gt;&lt;span class="sr"&gt;!&lt;/span&gt;&lt;span class="se"&gt;[&lt;/span&gt;&lt;span class="sr"&gt;-&lt;/span&gt;&lt;span class="se"&gt;\w])&lt;/span&gt;&lt;span class="sr"&gt;color&lt;/span&gt;&lt;span class="se"&gt;\s&lt;/span&gt;&lt;span class="sr"&gt;*:/gi&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Forced font size (inline style)&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;re&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sr"&gt;/style="&lt;/span&gt;&lt;span class="se"&gt;[^&lt;/span&gt;&lt;span class="sr"&gt;"&lt;/span&gt;&lt;span class="se"&gt;]&lt;/span&gt;&lt;span class="sr"&gt;*font-size&lt;/span&gt;&lt;span class="se"&gt;\s&lt;/span&gt;&lt;span class="sr"&gt;*:/gi&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Possible inline page number&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;re&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sr"&gt;/&amp;lt;p&lt;/span&gt;&lt;span class="se"&gt;[^&lt;/span&gt;&lt;span class="sr"&gt;&amp;gt;&lt;/span&gt;&lt;span class="se"&gt;]&lt;/span&gt;&lt;span class="sr"&gt;*&amp;gt;&lt;/span&gt;&lt;span class="se"&gt;\s&lt;/span&gt;&lt;span class="sr"&gt;*&lt;/span&gt;&lt;span class="se"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;page&lt;/span&gt;&lt;span class="se"&gt;\s&lt;/span&gt;&lt;span class="sr"&gt;*&lt;/span&gt;&lt;span class="se"&gt;)?\d{1,4}\s&lt;/span&gt;&lt;span class="sr"&gt;*&amp;lt;&lt;/span&gt;&lt;span class="se"&gt;\/&lt;/span&gt;&lt;span class="sr"&gt;p&amp;gt;/gi&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Soft hyphen&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;re&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sr"&gt;/­|&amp;amp;shy;/g&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
&lt;span class="p"&gt;];&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt;&lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nf"&gt;walk&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;dir&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;entry&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;fs&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;readdirSync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;dir&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;withFileTypes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;}))&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;full&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;path&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;dir&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;entry&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;entry&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;isDirectory&lt;/span&gt;&lt;span class="p"&gt;())&lt;/span&gt; &lt;span class="k"&gt;yield&lt;/span&gt;&lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nf"&gt;walk&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;full&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;/&lt;/span&gt;&lt;span class="se"&gt;\.&lt;/span&gt;&lt;span class="sr"&gt;x&lt;/span&gt;&lt;span class="se"&gt;?&lt;/span&gt;&lt;span class="sr"&gt;html&lt;/span&gt;&lt;span class="se"&gt;?&lt;/span&gt;&lt;span class="sr"&gt;$/i&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;entry&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="k"&gt;yield&lt;/span&gt; &lt;span class="nx"&gt;full&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;root&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt;
&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;root&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Usage: node lint-epub.js &amp;lt;unzipped-epub-folder&amp;gt;&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;exit&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;total&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;file&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nf"&gt;walk&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;root&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;lines&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;fs&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;readFileSync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;file&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;utf8&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;split&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="se"&gt;\n&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nx"&gt;lines&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;forEach&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;line&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;re&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;checks&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nx"&gt;re&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;lastIndex&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;re&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;line&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;path&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;relative&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;root&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;file&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;:&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;  &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
        &lt;span class="nx"&gt;total&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;});&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;total&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="s2"&gt;`\n&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;total&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; possible issue(s) found`&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;No common issues found&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;exitCode&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;total&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Run against a test chapter seeded with mistakes, it reports:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;OEBPS/ch1.xhtml:4  Run of non-breaking spaces (manual indent)
OEBPS/ch1.xhtml:5  Empty paragraph (blank line used for spacing)
OEBPS/ch1.xhtml:6  Forced text color (inline style)
OEBPS/ch1.xhtml:7  Forced font size (inline style)
OEBPS/ch1.xhtml:8  Tab character
OEBPS/ch1.xhtml:9  Possible inline page number
OEBPS/ch1.xhtml:12  Soft hyphen

7 possible issue(s) found
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;On a clean file it prints "No common issues found" and exits with code 0, so you can drop it into a build script or CI step. It deliberately ignores &lt;code&gt;background-color&lt;/code&gt; and a number inside a normal sentence, so it doesn't drown you in false alarms. Treat every hit as a lead, not a verdict, and fix it in the source document.&lt;/p&gt;

&lt;h2&gt;
  
  
  A Pre-Upload Checklist
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;No page numbers, headers or footers in the text&lt;/li&gt;
&lt;li&gt;Indents and spacing come from paragraph styles, not tabs, spaces or blank lines&lt;/li&gt;
&lt;li&gt;Chapters start with real page breaks and Heading 1 styles&lt;/li&gt;
&lt;li&gt;Body text has no forced color, size or alignment, and reads correctly in dark mode&lt;/li&gt;
&lt;li&gt;No boxes, question marks or broken words from unsupported characters or soft hyphens&lt;/li&gt;
&lt;li&gt;The TOC is generated from headings, and every entry works&lt;/li&gt;
&lt;li&gt;Every external link opens the right page&lt;/li&gt;
&lt;li&gt;Images are sharp, and no body text lives inside an image&lt;/li&gt;
&lt;li&gt;Tables fit a phone screen or have been simplified&lt;/li&gt;
&lt;li&gt;The file matches your title, subtitle and description, with no duplicated or missing content&lt;/li&gt;
&lt;li&gt;EPUBCheck reports no errors, and the book has been previewed on several devices&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  When to Hire a Formatter
&lt;/h2&gt;

&lt;p&gt;DIY formatting works well for straightforward novels and simple nonfiction. It gets harder with complex nonfiction, many images, tables, footnotes, poetry with exact line breaks, fixed layout or a book going to several retailers. It's also worth getting help if a file keeps coming back with quality flags.&lt;/p&gt;

&lt;p&gt;Western Reflections Publishing offers &lt;a href="https://westernreflectionspublishing.com/book-formatting-services/" rel="noopener noreferrer"&gt;professional book formatting services&lt;/a&gt; for print interiors, and separate &lt;a href="https://westernreflectionspublishing.com/ebook-conversion-services/" rel="noopener noreferrer"&gt;EPUB and Kindle conversion&lt;/a&gt; for ebooks, with files checked in Kindle Previewer before delivery.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQs
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Why was my ebook rejected by KDP?
&lt;/h3&gt;

&lt;p&gt;Usually because of an unsupported file type, a conversion failure or a quality issue found after upload. Common quality flags include inline page numbers, forced font colors, broken table of contents links, blurry images, tables cut off on screen and metadata that doesn't match the book. KDP's email names the issue category.&lt;/p&gt;

&lt;h3&gt;
  
  
  What are common ebook formatting mistakes?
&lt;/h3&gt;

&lt;p&gt;The most common are page numbers left from print files, tabs and spaces used for indents, blank lines for spacing, missing heading styles, broken tables of contents, forced font colors, unsupported characters, blurry images and wide tables. Most come from treating a reflowable ebook like a fixed print page.&lt;/p&gt;

&lt;h3&gt;
  
  
  How do I validate an EPUB file?
&lt;/h3&gt;

&lt;p&gt;Run it through EPUBCheck, the official validator maintained by the W3C, using &lt;code&gt;java -jar epubcheck.jar mybook.epub&lt;/code&gt;. Fix every error and review the warnings. Then preview the book in Kindle Previewer or on real devices, because a valid file can still have visual and readability problems.&lt;/p&gt;

&lt;h3&gt;
  
  
  Can an ebook pass upload and still get a quality warning?
&lt;/h3&gt;

&lt;p&gt;Yes. KDP reviews quality after publishing, often in response to customer reports. Depending on severity, a book can be removed from sale until it's fixed, or stay on sale with a temporary quality warning on its product page. Critical issues always lead to removal until corrected.&lt;/p&gt;

&lt;h3&gt;
  
  
  Should I convert a PDF to an ebook?
&lt;/h3&gt;

&lt;p&gt;Generally no. PDFs are fixed print layouts, so converting them carries over page numbers, headers, hard line breaks and spacing problems. Start from a clean Word file or source document with proper styles, or rebuild the ebook in a formatting tool designed for reflowable text.&lt;/p&gt;

&lt;h3&gt;
  
  
  What file format is best for uploading an ebook?
&lt;/h3&gt;

&lt;p&gt;For KDP, use EPUB, DOCX or KPF. MOBI is no longer accepted. For Apple Books, Kobo and most distributors, a valid EPUB is the standard. A single, well-built EPUB that passes EPUBCheck usually works everywhere, which is why many authors make it their master ebook file.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrapping Up
&lt;/h2&gt;

&lt;p&gt;Ebook formatting mistakes get books rejected because ebooks aren't printed pages. Format for reflow, use styles instead of spaces, let readers control color and size, build the TOC from headings, keep images sharp and tables small, and match the file to your listing. Then run EPUBCheck, lint the file and preview it before you upload, not after the quality email arrives.&lt;/p&gt;

&lt;p&gt;If you'd rather hand the file to someone who does this every day, Western Reflections offers &lt;a href="https://westernreflectionspublishing.com/book-formatting-services/" rel="noopener noreferrer"&gt;professional book formatting services&lt;/a&gt; built for KDP, IngramSpark and other retailers.&lt;/p&gt;

</description>
      <category>writing</category>
      <category>epub</category>
      <category>javascript</category>
      <category>beginners</category>
    </item>
    <item>
      <title>Children's Picture Book Page Counts and Why Publishers Care</title>
      <dc:creator>Jay Barker</dc:creator>
      <pubDate>Wed, 04 Nov 2026 02:04:24 +0000</pubDate>
      <link>https://dev.to/jaybarker/childrens-picture-book-page-counts-and-why-publishers-care-4ejm</link>
      <guid>https://dev.to/jaybarker/childrens-picture-book-page-counts-and-why-publishers-care-4ejm</guid>
      <description>&lt;p&gt;A first-time author finishes a picture book draft. It's charming, the read-aloud rhythm works, and it runs to 45 pages. Then every editor, agent and critique partner says the same thing: make it 32.&lt;/p&gt;

&lt;p&gt;Why 32? Why not 30, or 45, or whatever the story needs?&lt;/p&gt;

&lt;p&gt;The answer has less to do with taste than with paper, folding machines and money. Once you understand where the picture book page count comes from, you can plan your story in the units that actually matter: spreads. This post explains the printing logic, how many spreads per book you really get, why publishers care so much, and what changes when you self-publish through print on demand. There's also a small JavaScript script at the end that maps any page count into spreads, so you can plan pagination before an illustrator draws a single line.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Short Answer: 32 Pages, Usually
&lt;/h2&gt;

&lt;p&gt;The standard picture book is 32 pages. You'll also see 24, 40 and 48 pages, but 32 is the default that publishers expect, and it's the length most new writers should aim for.&lt;/p&gt;

&lt;p&gt;Two related formats work differently. Board books for babies and toddlers are much shorter, often around 12 to 16 pages of thick card. Early readers and chapter books are longer and follow their own conventions. Everything below is about the classic illustrated picture book for children of roughly 3 to 8.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why 32? It Starts With Printing
&lt;/h2&gt;

&lt;p&gt;Traditional picture books are printed on large sheets of paper, then folded and trimmed. As illustrator and author Debbie Ohi explains in her &lt;a href="https://debbieohi.substack.com/p/picture-books-101-part-3-understanding" rel="noopener noreferrer"&gt;guide to picture book format&lt;/a&gt;, "Books are produced in page-count multiples of eight." A large sheet holding eight picture book pages on each side folds into a signature, and "a picture book is typically 32 pages or two signatures."&lt;/p&gt;

&lt;p&gt;That's the whole secret. Two signatures make 32 pages. If a publisher wants a longer book, they add at least one more signature, which is why, in Ohi's words, "you'll see picture books with 32, 40, or 48 pages."&lt;/p&gt;

&lt;p&gt;An odd length like 30 or 36 pages doesn't save anything. The press still runs full sheets, so the publisher pays for the paper either way, or pays more for special handling. Matching the book to signatures keeps printing efficient and costs predictable, which is why editors ask new writers to submit at the standard length and leave any change to the publisher.&lt;/p&gt;

&lt;h2&gt;
  
  
  Not All 32 Pages Hold Story
&lt;/h2&gt;

&lt;p&gt;Here's where many writers get caught out. A 32-page book does not give you 32 pages of story.&lt;/p&gt;

&lt;h3&gt;
  
  
  Front and Back Matter
&lt;/h3&gt;

&lt;p&gt;Some pages always go to things that aren't the story:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Title page:&lt;/strong&gt; sometimes with a half title before it&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Copyright page:&lt;/strong&gt; ISBN, credits and publisher details&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Dedication:&lt;/strong&gt; often sharing a page with the copyright&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Back matter:&lt;/strong&gt; in some books, an author's note, glossary or activity page&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;In a tight 32-page book, these pages are taken from the same pool your story needs.&lt;/p&gt;

&lt;h3&gt;
  
  
  Separate-Ended vs Self-Ended
&lt;/h3&gt;

&lt;p&gt;How the book is bound also changes your page budget.&lt;/p&gt;

&lt;p&gt;In a &lt;strong&gt;separate-ended&lt;/strong&gt; book, the endpapers, the decorative pages just inside the covers, are made from different paper and added outside the 32 pages. Ohi notes that a 32-page separate-ended book "has 14 full spreads plus 1-2 extra single pages" once front matter is accounted for.&lt;/p&gt;

&lt;p&gt;In a &lt;strong&gt;self-ended&lt;/strong&gt; book, "the first and last pages of the book block are pasted directly onto the cover," so no extra paper is needed. The catch is that those pasted pages come out of your 32, and in many books the next pages serve as endpapers too. Self-ended books therefore leave fewer pages for the story.&lt;/p&gt;

&lt;p&gt;You can usually tell the difference by touch. If the endpapers feel like different paper from the story pages, the book is probably separate-ended.&lt;/p&gt;

&lt;h3&gt;
  
  
  Think in Spreads, Not Pages
&lt;/h3&gt;

&lt;p&gt;Readers don't experience a picture book page by page. They see two facing pages at once, a spread, and then they turn.&lt;/p&gt;

&lt;p&gt;Page 1 is a right-hand page on its own. After that, pages 2 and 3 face each other, then 4 and 5, and so on, until page 32 sits alone on the left. That gives a 32-page book 15 full spreads plus two single pages. Subtract the title page, copyright and dedication, and the story typically gets around 12 to 14 spreads. That's your real canvas, and it's the number to plan around.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why Publishers Care
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Printing Cost and Price Point
&lt;/h3&gt;

&lt;p&gt;Picture books are full color, which makes them expensive to print. Every extra signature adds paper, ink and binding cost, and that has to be recovered through the retail price. Publishers know the price range parents and libraries expect to pay, so the page count is partly a business decision made long before the illustrations.&lt;/p&gt;

&lt;h3&gt;
  
  
  Pacing and Page Turns
&lt;/h3&gt;

&lt;p&gt;The page turn is a picture book's most powerful storytelling tool. It's the pause before a reveal, the setup before the punchline, the "what happens next?" that keeps a child leaning in. Fourteen or so spreads give a story enough room for a beginning, rising tension and a satisfying ending, without dragging.&lt;/p&gt;

&lt;h3&gt;
  
  
  Read-Aloud Length
&lt;/h3&gt;

&lt;p&gt;Picture books are mostly read aloud, often at bedtime, by an adult to a child whose attention has limits. The 32-page format, combined with a modest word count, keeps a reading to a few minutes. Many editors look for manuscripts in the hundreds of words rather than the thousands, though there's no fixed rule.&lt;/p&gt;

&lt;h3&gt;
  
  
  Illustration Budget and Schedule
&lt;/h3&gt;

&lt;p&gt;Every spread is a piece of art. More pages mean more illustrations, more fees and a longer schedule. For traditional publishers and self-publishers alike, the page count sets the scale of the illustration project.&lt;/p&gt;

&lt;h2&gt;
  
  
  What Changes When You Self-Publish
&lt;/h2&gt;

&lt;p&gt;Print on demand doesn't use signatures in the same way, so the multiples-of-eight rule loosens. But it brings rules of its own, and some of them matter a lot for picture books.&lt;/p&gt;

&lt;h3&gt;
  
  
  Print-on-Demand Page Rules
&lt;/h3&gt;

&lt;p&gt;On Amazon KDP, paperbacks start at 24 pages. For color picture books, the key detail is in the &lt;a href="https://kdp.amazon.com/en_US/help/topic/G201834340" rel="noopener noreferrer"&gt;KDP paperback printing costs&lt;/a&gt; table for Amazon.com:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Premium color, 24 to 40 pages:&lt;/strong&gt; a flat $3.60 per copy at regular trim sizes, or $4.20 at large trim sizes&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Premium color, 42 pages or more:&lt;/strong&gt; $1.00 plus $0.065 per page at regular trim, or $0.08 per page at large trim&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Standard color:&lt;/strong&gt; available only for books of 72 to 600 pages, so it isn't an option for a typical picture book&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;KDP treats any book wider than 6.12 inches or taller than 9 inches as large trim, which includes most picture book shapes, such as 8.5 by 8.5 inches.&lt;/p&gt;

&lt;p&gt;That flat rate is good news. A 24-page and a 40-page premium color book cost the same to print, so a 32-page book costs no more than a 24-page one. For a large-trim book listed at $12.99, KDP's 60% royalty works out to about $7.79, minus $4.20 printing, leaving about $3.59 per Amazon sale. At $9.99, the same book earns about $1.79.&lt;/p&gt;

&lt;h3&gt;
  
  
  The Hardcover Catch
&lt;/h3&gt;

&lt;p&gt;Many authors want a hardcover picture book, and this is where KDP gets in the way. According to &lt;a href="https://kdp.amazon.com/en_US/help/topic/GHT976ZKSKUXBB6H" rel="noopener noreferrer"&gt;KDP hardcover printing costs&lt;/a&gt;, KDP hardcovers must have between 75 and 550 pages. A 32-page hardcover simply isn't possible on KDP.&lt;/p&gt;

&lt;p&gt;If a hardcover matters to you, look at other print-on-demand services such as IngramSpark, or get quotes from an offset printer for a short run. Check each printer's current minimums and color options before you finalize your layout, because they differ.&lt;/p&gt;

&lt;h3&gt;
  
  
  Convention Still Matters
&lt;/h3&gt;

&lt;p&gt;Even when the printer doesn't demand multiples of eight, readers, librarians and bookstores expect picture books to look and feel a certain way. A 32-page book signals "real picture book." And if your book ever moves to offset printing for a bigger run, signatures come straight back. Designing to 24, 32 or 40 pages from the start keeps every option open.&lt;/p&gt;

&lt;h2&gt;
  
  
  Plan Your Page Map With a Tiny Script
&lt;/h2&gt;

&lt;p&gt;Before you brief an illustrator, it helps to see exactly which page numbers fall where. This small Node.js script maps a picture book into openings, marks front matter and pasted-down pages, and counts how many full story spreads you get.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// pagemap.js: map a picture book's pages into openings (what the reader sees)&lt;/span&gt;
&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;pageMap&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;totalPages&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;selfEnded&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;frontMatter&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;backMatter&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{})&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;totalPages&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="mi"&gt;8&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="nx"&gt;totalPages&lt;/span&gt; &lt;span class="o"&gt;%&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Use an even page count of 8 or more&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;pasted&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;selfEnded&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;totalPages&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[];&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;usable&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[];&lt;/span&gt;
  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;p&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;p&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;=&lt;/span&gt; &lt;span class="nx"&gt;totalPages&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;p&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;pasted&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;includes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;p&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="nx"&gt;usable&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;p&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;front&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;usable&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;slice&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;frontMatter&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;back&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;backMatter&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="nx"&gt;usable&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;slice&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="nx"&gt;backMatter&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[];&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;role&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;p&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
    &lt;span class="nx"&gt;pasted&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;includes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;p&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;pasted to cover&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;
    &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;front&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;includes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;p&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;front matter&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;
    &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;back&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;includes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;p&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;back matter&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;
    &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;story&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="c1"&gt;// Page 1 is a right-hand page on its own; then 2-3, 4-5 ... face each other&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;openings&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[[&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;]];&lt;/span&gt;
  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;p&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;p&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="nx"&gt;totalPages&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;p&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;openings&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;([&lt;/span&gt;&lt;span class="nx"&gt;p&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;p&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;]);&lt;/span&gt;
  &lt;span class="nx"&gt;openings&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;([&lt;/span&gt;&lt;span class="nx"&gt;totalPages&lt;/span&gt;&lt;span class="p"&gt;]);&lt;/span&gt;

  &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;storySpreads&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;storySingles&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;pages&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;openings&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;roles&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;pages&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;role&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;label&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;pages&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;-&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;padEnd&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;label&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;roles&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt; | &lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;story&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;roles&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;r&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;story&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;pages&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;story&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;storySpreads&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="nx"&gt;storySingles&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="nx"&gt;story&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`\nStory: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;storySpreads&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; full spreads + &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;storySingles&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; single page&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;storySingles&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="dl"&gt;''&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;s&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;pages&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;32&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;ends&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;separate&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;front&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;2&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;slice&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="nf"&gt;pageMap&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;Number&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;pages&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;selfEnded&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;ends&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;self&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;frontMatter&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;Number&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;front&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Run it with a page count, the binding type and the number of front matter pages:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;node pagemap.js 32 separate 2
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The output starts like this:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;1      front matter
2-3    front matter | story
4-5    story | story
...
30-31  story | story
32     story

Story: 14 full spreads + 2 single pages
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;That matches Ohi's "14 full spreads plus 1-2 extra single pages" for a separate-ended 32-page book. Try the alternatives:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;node pagemap.js 32 self 3&lt;/code&gt; gives &lt;strong&gt;13 full spreads + 1 single page&lt;/strong&gt;, because pages 1 and 32 are pasted to the cover.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;node pagemap.js 24&lt;/code&gt; gives &lt;strong&gt;10 full spreads + 2 single pages&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;node pagemap.js 40&lt;/code&gt; gives &lt;strong&gt;18 full spreads + 2 single pages&lt;/strong&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Use the output to number your manuscript, plan where page turns land and give an illustrator a clear brief. If your book has endpaper art inside a self-ended book, increase the front matter number to reserve those pages too.&lt;/p&gt;

&lt;h2&gt;
  
  
  Writing to the Page Count
&lt;/h2&gt;

&lt;p&gt;A few habits make fitting a story into 32 pages much easier:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Paginate a draft for yourself.&lt;/strong&gt; Split the text into 12 to 14 chunks, one per spread, and see whether each chunk earns its own picture.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Put the turns in the right places.&lt;/strong&gt; Each spread should end with a reason to turn the page.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cut words, not moments.&lt;/strong&gt; If you have too many spreads, merge scenes or trim description the pictures can carry instead.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Leave the art direction out of submissions.&lt;/strong&gt; Ohi is blunt that layout choices are "up to the illustrator and art director, NOT the writer," so keep your private page map out of a traditional submission.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Make a dummy.&lt;/strong&gt; Fold eight sheets of paper in half, staple them, and you have a rough 32-page book to test your pacing by hand.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;If you're self-publishing, you play the publisher's role too, so the page map becomes your brief for the illustrator and designer. Working with an experienced team helps here. Western Reflections Publishing offers &lt;a href="https://westernreflectionspublishing.com/childrens-book-writing-services/" rel="noopener noreferrer"&gt;children's book writing services&lt;/a&gt; for authors who want help shaping a story to the format, and &lt;a href="https://westernreflectionspublishing.com/ghostwriting-services/" rel="noopener noreferrer"&gt;ghostwriting&lt;/a&gt; for authors who'd rather hand over the drafting.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQs
&lt;/h2&gt;

&lt;h3&gt;
  
  
  How many pages is a picture book?
&lt;/h3&gt;

&lt;p&gt;Most picture books are 32 pages. Shorter books of 24 pages and longer ones of 40 or 48 pages are also common. These numbers come from printing in signatures, sheets that fold into groups of pages, usually in multiples of eight. New writers are generally advised to plan for 32.&lt;/p&gt;

&lt;h3&gt;
  
  
  Why are picture books 32 pages?
&lt;/h3&gt;

&lt;p&gt;Because traditional printing works in multiples of eight. A large sheet folds into a signature, and two 16-page signatures make 32 pages. That length also suits read-aloud time, pacing and the price parents and libraries expect, so it became the industry standard.&lt;/p&gt;

&lt;h3&gt;
  
  
  How many spreads are in a 32-page picture book?
&lt;/h3&gt;

&lt;p&gt;A 32-page book has 15 full spreads plus a single page at the start and end. After the title page, copyright and dedication, a separate-ended book typically has about 14 full spreads plus one or two single pages for the story. A self-ended book has slightly fewer.&lt;/p&gt;

&lt;h3&gt;
  
  
  Do the title and copyright pages count in the page count?
&lt;/h3&gt;

&lt;p&gt;Yes. The title page, copyright page, dedication and any back matter all come out of the total page count. In a self-ended book, the endpapers do too. That's why a 32-page picture book usually has only 12 to 14 spreads of story.&lt;/p&gt;

&lt;h3&gt;
  
  
  Can a self-published picture book be 24 pages?
&lt;/h3&gt;

&lt;p&gt;Yes. KDP paperbacks start at 24 pages, and premium color printing for 24 to 40 pages costs a flat $3.60 at regular trim or $4.20 at large trim on Amazon.com. Because the price is flat across that range, a 32-page book costs no more to print than a 24-page one.&lt;/p&gt;

&lt;h3&gt;
  
  
  Can I make a 32-page hardcover picture book on KDP?
&lt;/h3&gt;

&lt;p&gt;No. KDP hardcovers require at least 75 pages, so a standard 32-page picture book can't be printed as a KDP hardcover. Authors who want a hardcover usually use another print-on-demand service, such as IngramSpark, or an offset printer for a short run.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrapping Up
&lt;/h2&gt;

&lt;p&gt;The picture book page count isn't arbitrary. Thirty-two pages comes from printing in signatures, and it happens to fit read-aloud time, pacing and price as well. Plan your story in spreads, expect around 12 to 14 of them for the story itself, and if you self-publish, know your printer's rules before you design, especially the hardcover minimum on KDP.&lt;/p&gt;

&lt;p&gt;If you're ready to turn your idea into a finished book, Western Reflections Publishing can help you &lt;a href="https://westernreflectionspublishing.com/childrens-book-writing-services/" rel="noopener noreferrer"&gt;write and publish a picture book&lt;/a&gt;, and lists its &lt;a href="https://westernreflectionspublishing.com/pricing/" rel="noopener noreferrer"&gt;published pricing&lt;/a&gt; on its site.&lt;/p&gt;

</description>
      <category>writing</category>
      <category>beginners</category>
      <category>books</category>
      <category>javascript</category>
    </item>
  </channel>
</rss>
