Stop using grey text (2025)

(catskull.net)

99 points | by catskull 2 days ago ago

71 comments

  • tejohnso 2 days ago

    Isn't most of the text on the page grey? It's not white, it's rgb(215,215,216). And the background is not black. Some worse examples are shown, but then the message comes across as "don't use grey unless you know what you're doing, like I do, because I'm using grey while I tell you not to use grey, but mine is okay."

    Maybe aside from the unset option, something more specific about a minimum contrast threshold would be useful. Ideally the author wouldn't be breaking below that threshold themselves while explaining it.

    • quuxplusone 2 days ago

      That, plus the line "Or, you could just not do it [change your colors with CSS] in the first place which would look like this:" — followed by a super-duper-CSS-styled box thingie full of gray text.

    • batisteo a day ago
    • tom_ a day ago

      The background is indeed not black, but if it isn't actually white then it's close enough that the text, which i'm sure is indeed mostly actually grey rather than black, shows up well. I've seen worse.

    • cratermoon a day ago

      Indeed the WCAG guidelines provide the following criteria

      * The visual presentation of text and images of text has a contrast ratio of at least 4.5:1, except for the following * Large Text: Large-scale text and images of large-scale text have a contrast ratio of at least 3:1

      Grey is not the problem. Low contrast is the problem.

      • Barbing a day ago

        Did anyone calculate the contrast on this page?

        • hulitu a day ago

          I guess it depends on your monitor, on ambient lighting...

          • jasomill a day ago

            Of course it does.

            In the absence of reflected ambient light, the contrast ratio of black to the dimmest non-black color on an OLED display is infinite, but that doesn't mean black-on-darkest-grey text is necessarily readable, even in a perfectly dark room.

  • sherry-sherry a day ago

    No.

    There's pretty much nothing in the natural world that has the contrast ratio a modern screen can produce. It is easier on the eyes to not have blindingly high contrast.

    No printed page in any book or magazine you've seen has ever had contrast ratio a screen can show. It's just not possible to do.

    Legibility can be an issue, and is good to discuss. I agree that when something like "@media (prefers-contrast: more)" is set, text should be at a higher contrast level for those with lower vision. But don't blind everyone else in the process.

    >... the amount of times per day I ask myself if I’m literally going blind, only to find out the “designer” decided for me how I should best read their website.

    Yes? That's what the designers of literally everything do, decide how it will be presented to you. The magic part of HTML/CSS is you can change that to suit your needs.

    • mikae1 a day ago

      The idea that "nothing in the natural world has the contrast of a modern display" is backwards and keeps being repeated. The real world has far more contrast than any screen that can be manufactured.

      Think about standing outside on a sunny day. The sunlit pavement might be tens of thousands of times brighter than the shadow under a tree. Look up at a bright cloud and then glance into a shaded doorway. Your eyes can still make out detail in both. The dynamic range of the real world the ratio between the darkest and brightest things present at the same time is enormous.

      Cameras struggle with this. When you take a photo, the camera can't always capture both the bright sky and the dark ground correctly at the same time. Either the sky blows out to white or the shadows become black. That limitation is why HDR photography and exposure bracketing exists.

      Even modern digital cameras still capture a far wider range of brightness than most displays can show. That's why we use tone mappers in photography and video. Tone mapping compresses the huge brightness range captured by the camera so it can fit onto a display that only has a tiny slice of that range.

      So screens are not "more contrasty" than reality. They're the opposite. Displays are a bottleneck that force a very wide real world brightness range into something much smaller.

      Your eyes are also incredibly good at adapting. If you look at a white page of paper in sunlight and then look at black ink on it, the contrast between the two is extremely strong. Snow in sunlight next to a dark rock is another example. Nature is full of intense light and dark differences.

      When web developers avoid strong contrast because it feels "unnatural", they're misunderstanding the physics and the biology. High contrast between text and background isn't artificial at all. It's actually closer to how humans evolved to see clearly: dark shapes against bright surfaces or bright shapes against dark ones.

      The real ergonomic problem with screens usually isn't contrast between text and background. It's screen brightness relative to the environment. Many people run their monitors far brighter than the room around them. If a screen is glowing like a light source in a dim room, the whole display becomes visually harsh and fatiguing. In ergonomics, the usual advice is to match the screen's brightness to the surrounding lighting so the display feels like part of the environment rather than a flashlight in your face.

      When display brightness is set appropriately, strong text contrast simply improves legibility. The discomfort people blame on "too much contrast" is often just a monitor that's set far brighter than it should be. Reality itself contains vastly wider brightness differences than any display, so high contrast text isn't unnatural at all. It's a practical way to make information clear within the limited dynamic range that screens can actually show.

    • hulitu a day ago

      > There's pretty much nothing in the natural world that has the contrast ratio a modern screen can produce.

      The natural world has much better contrast than the majority of screens. Not everyone has or affords a Mac Retina display. The main issue is, that, since some 10 years, UX experts appeared who pushed away configurability in favor of gray on gray ( remember when you were able to select the background and foreground color ?). The majority of screens have crappy contrasts (100:1).

  • akrakesh a day ago

    The article could have been more useful if its point was just 'use sufficient contrast'. As it is, the article is overly prescriptive, and feels like trying too hard to be sensational or cute.

    • designerarvid a day ago

      Maybe the author is not that informed?

      Maximum readability for humans is black text on light grey. Contrast is not the only thing that matters.

  • manbash a day ago

    I was reviewing a confluence page which was reviewed my many stakeholders. Something bugged me to an excruciating extent about the content of the page: something was off at some parts of the text. I inspected the page and it turns out the font color somehow changed to a mildly grayer color than black. This was likely due to a copy-and-paste that has gone wrong.

    • carcabob a day ago

      This problem has been haunting me for years, except in Google Docs. At some point, some template my team used had slightly gray text, and I STILL find it cropping up in our most recent documents.

  • ccleve a day ago
    • chihuahua a day ago

      But the author of that page is not concerned with readability or accessibility. He just wants things to look cool and design-y. One piece of supporting evidence he cites is some random photo he took that doesn't contain #000000 black. That doesn't mean anything, it could be that it's over-exposed, or has poor contrast, or had some silly filter applied. This leads me to think that the author of that page doesn't know what he's talking about.

      • russelldjimmy a day ago

        Additions without any evidence:

        > He just wants things to look cool and design-y

        > some random photo

        > That doesn't mean anything

        This leads me to believe the author of this post doesn’t know what they’re talking about

      • 112233 a day ago

        So you routinely encounter photographs that have noticable areas where sensor did not receive any light during exposure? To the point where you feel not having completely unlit parts of a photo is a sign of over-exposure or filters? Are you an astrophotographer?

    • kristopolous a day ago

      Right but the medium of a canvas isn't the same as an electronic screen.

      What if you empower the user to control their device and use reasonable baselines that maximize legibility

    • neya a day ago

      Wow, I was searching for this exact link for more than a decade (!). I remember seeing it on HN when I was new here and couldn't find the article ever again. Thanks for sharing!

    • cratermoon a day ago

      16161d text on a background of fafafc is an 18:1 ratio, sufficient to meet WCAG AA criteria

  • shevy-java a day ago

    This is why I still use the marquee tag. It catches people's attention right away! Much more so than grey text on grey background could.

    I do use pink for it though, usually pink on red or yellow background. It makes people feel more engaged and they write all sorts of happy emails about how epic blinking pink on rainbow ponicorn background wallpapers are. The 90s were a great time for the global internets ...

  • anilakar a day ago

    Your design will be looked at in direct sunlight on a six inch, non-color-calibrated screen. Stop using low contrast and extralight fonts.

    Next time we'll ship your Mac. No, we won't give you a new one.

  • Twey 2 days ago

    More generally use a contrast checker on any pair of colours that are likely to be in juxtaposition and need to be legible.

    Helpful of the website to demonstrate the problem in situ in its tag links and code comments! (Maybe just in dark mode?)

    • cryzinger a day ago

      WCAG color contrast checkers in particular have never steered me wrong. It's interesting (but makes sense) that contrast needs to be higher for small text than for large text!

    • SoftTalker 2 days ago

      Yes, you want enough contrast, but not too much. Either extreme is hard to look at for long periods.

  • SoftTalker 2 days ago

    Dark/charcoal grey is better than pure black for text. But it's still dark enough that most people would call it black.

    • ChrisMarshallNY a day ago

      The problem is contrast, really. Some color combos are terrible, and you also have issues with color-blindness (which is why gray is used a lot).

      Gray text, against a gray background, can suck.

      I’m getting on in years, and low-contrast text affects me a lot more, these days, than it used to.

      • 112233 a day ago

        Yeah, nothing like neon green on magenta. So much contrast, my eyes each read their own line... ZX Spectrum had some excellent color combinations

        • hulitu a day ago

          > ZX Spectrum had some excellent color combinations

          Yes, compared with the abominations that are Windows 10, 11 and Android, ZX Spectrum was luxury.

    • carlosjobim a day ago

      It's not, that's a myth. The blackest black your monitor is capable of is best for text.

    • mr-pink a day ago

      so wrong

  • duskdozer a day ago

    Well, as long as you're not going to decide to make the dark background lighter to accommodate the brighter text...

    But I would be in favor of sites using variables more so that personal customization is easier. But often this goes against their desire for "branding".

  • xnx a day ago

    Black text on a gray background is how the web was intended to be experienced.

    • wombatpm a day ago

      The number of PowerPoint and slide presentations I sat through with sans serif white and yellow text on a dark purple background still gives me nightmares. For my presentation I went black over medium-light grey. The audience sighed with relief.

    • moron4hire a day ago

      Blue hyperlinks. Purple hyperlinks after you had clicked them. Images with the blue hyperlink border. Tables with Extra Chonky borders. Row and Col span. Guestbooks.

      • jasomill a day ago

        Don't forget page view counters, web rings, "Under Construction", and "Best Viewed with Internet Explorer".

    • kristopolous a day ago

      What? No it wasn't. First browser

      https://www.w3.org/MarkUp/tims_editor

      • hulitu a day ago

        Oh, no. It had a visible scrollbar. And clearly delimited UI elements. And everything square. And readable text. How primitive. /s

        • kristopolous a day ago

          I'd be so down for a black and white modern interface like this. I know the attempts ... they aren't like this. (I've got a next)

  • benterix a day ago

    This ship has sailed a long time ago. The idea of "low contrast is good for the eyes" was popularized among designers well over a decade ago, together with another one that tiny fonts are elegant (I read HN at 120% and I don't wear glasses).

  • washbasin a day ago

    I created a ycombinator account after years of resisting, just to respond to this post. Stop creating web pages with huge-ass gutters/margins.

    If you are concerned about design you would realize your page looks ridiculous and borderline illegible on modern screens (that are not phones). Text color is an issue, but layout is worse.

    • npilk a day ago

      This doesn't seem too far off from ~80 characters per line, which I believe is best practice for readability. Though you could make the column wider and bump up the font size and it would be even more readable.

    • sherry-sherry a day ago

      Have you ever seen a book?

      They have huge gutters and margins, and not-quite-black text on creme/off-white/never-actually-white backgrounds... why? Because it's easier of the eyes for long blocks of text.

      • washbasin a day ago

        This page isn't a long block of text. Look at what Reader View does to pages. It doesn't ADD gutters and margins, it shrinks them.

    • jasomill a day ago

      Depends on the width of the browser window. Wide margins that are welcome in a full-page browser on a large or ultrawide display are cancer when I'm tiling windows 2 or 3 up on a smaller or narrower display.

    • cyberax a day ago

      Ah, thank you. The next version of the page will include a YUUUGE sitemap on the left and the table of contents on the right.

      We'll also add a wonderful floating text input box to let you chat with our helpful AI assistant.

  • dolebirchwood a day ago

    I appreciate the grey "LIKE?" text above the likes counter. Really drives the point home.

  • bee_rider a day ago

    Everyone should just use something like DarkReader to make these problems go away. Web devs who fiddle with the colors are annoying, but at least they are easy to ignore.

  • designerarvid a day ago

    Stupid rule. In that case, why ever change a color?

    Just stick to ensuring WCAG 2 AA rating. If your awesome design isn’t AA there better be a good reason. If it is, everything’s fine.

  • wobblywobbegong 2 days ago

    Screen brightness is a pretty important contributing factor. If you have this problem a lot, verify your screen is bright enough. ( Regardless of his point )

    • chrismorgan a day ago

      Or the other way round—if you feel the contrast is too high, your screen may well be too bright and you should reduce its brightness.

  • ChrisArchitect a day ago

    A related piece from 2022 that gets a bit more into the why, readability and Accessibility Guidelines evolution etc.

    Please Stop Using Grey Text (2022)

    https://tangledweb.xyz/please-stop-using-grey-text-3d3e71acf... (https://archive.is/QictZ) [https://news.ycombinator.com/item?id=31420938]

  • a day ago
    [deleted]
  • jmclnx 2 days ago

    Yes, I wish sites that use grey text should be investigated as part of the US disability act.

    People with even minor sight issues can have a hard time with sites designed that way. When I run across a site like that I usually try it in lynx, if the site does not work in lynx, I block it on my system so I would not waste my time with it.

  • signorovitch a day ago

    I’m looking at gray text on an off-white background right now :P

  • 8bitsrule a day ago

    Back in the day, for people who spent many hours each day in front of a 'display':

    1. People using TTY's used black ink on very-light-yellow roll paper, or

    2. Those lucky enough to have ADM-3 VDT's often chose light green or light orange on black.

    Just sayin.

    e.g. https://en.wikipedia.org/wiki/VT220#/media/File:DEC_VT220_te...

  • themafia a day ago

    > I actually believe increasing contrast for everyone improves the information density of our content.

    You used css to change the pointer. So instead of the I-Beam I had to use a regular pointer to select that text. Information density is nice but information access shouldn't be compromised either.

    Aside from that, while this is true, I'd think you'd then want something better for your users than "font-family: system-ui".

  • lelandbatey a day ago

    This takes me back to "contrast rebellion" back in 2011:

    https://contrastrebellion.com/

  • deafpolygon a day ago

    Funny how he says not to use that grey text, yet uses a similar shade for the word “LIKE?” at the bottom.

  • efilife a day ago

    I thought that the grey /* comment */ block was a demonstration of what not to do. Then I realized it's just a part of the page

  • spiderfarmer a day ago

    Increase Your Font Size First (2026)

  • msla a day ago

    While we're wishing, let's bring back serifs. I, for one, would like to be able to tell the difference between AI and Al without context clues, and using an inherently lossy font is the opposite of "readability".

    • AndrewStephens a day ago

      You are not alone.

      I got criticism on my blog for using a serif font but those people are just … wrong. Serif fonts are just better for reading at all font sizes.

      • efilife a day ago

        I wouldn't say they are wrong but complaining about a serif point seems very weird to me. Aren't there better things to complain about?

    • carcabob a day ago

      Agreed. I'm very glad Hacker News uses a typeface with serifs on 'I's, 'l's, and '1's. "Sans serif" can be descriptive, rather than prescriptive.

    • nikau a day ago

      Found secretary of education Linda McMahons account

    • bee_rider a day ago

      This Al fellow seems to have gotten up to all sorts of trouble! Probably because he keeps hallucinating.

      • carcabob a day ago

        For a while I'd see "Weird Al" in random headlines or something and my brain would read it as "Weird A.I." and I kept getting very confused.

    • GoblinSlayer a day ago

      When I saw yet another crooked google font I configured my browser to display all text in Verdana ignoring fonts chosen by page styles. It's much easier to read when everything is in one font to rule them all.