• (A)I Made This: What Could Go Wrong?

    (A)I Made This: What Could Go Wrong?

    I have been building WordPress themes for about 16 years now. I started with child themes, then builders, and then moved into custom development with Underscores. But I’ve never really delved (I think we can use this word again, right?) into plugin development. I taught myself to code in olden times, using BBEdit and Dreamweaver. I never picked up (nor was I interested in) build processes, React, tooling (gross). What I do know, and am interested in, is how the web is supposed to work for people: the conventions that we rely on, what makes an experience inclusive and accessible, and what a given use case technically requires versus opting for the shiniest solution.

    With the help of AI, those years of practical experience were all I needed to start building my own plugins, first with Claude and now with Studio. There have been small utilities I’ve wanted for various sites over the years, and usually the plugin I found in the WordPress Repository often felt like overkill (a multi-tool, plus an upsell!). With Studio’s AI agent, I’ve been able to build the simple, single-purpose versions myself: an accessible promotion banner that can display on specific pages and be dismissed, a small SVG shape generator for when a design needs to be less boxy, an admin utility that alerts me when a client’s domain is about to expire, so I can send a reminder before I get the “my site is broken!” email.

    I know what I want these tools to do, how I think they should do it, and what requirements to check for. Without AI, it is unlikely that I would have made it through the plugin-architecture learning curve on my own. I can do anything, but not everything, as David Allen might remind me.

    This is the positive outcome of what’s happening with AI right now. But the other side of this new capacity we all have is the tendency to get caught up in the machine’s momentum and accept what gets created at “It works! (P.S. I’m clearly a genius.)”

    (A)I Made This

    Someone recently shared a calendar tool a volunteer had built to embed on their website. It looked polished (if a tad Design By Claude). Attractive layout, categorized events, a clever interface. They’d built it with an AI agent platform, start to finish, without writing a line of code by hand. Impressive!

    I noted that font size was a bit small and then tried to tab through it with my keyboard.

    It didn’t work. No focus states, no logical tab order, interactive elements you couldn’t reach. A visitor using a screen reader or navigating without a mouse would have been locked out entirely. The client had been visually wowed and both they, and the volunteer, had no idea that what they had made was completely inaccessible. Not only did this person not write the code, they didn’t really have the code, not to debug, maintain, or explain. They had a working demo hosted within an app that they didn’t own.

    Making things is exciting

    Look, I know the thrill of making something work with your own bare hands. I don’t want to be the kind of elitist knowledge worker that says, “Only real developers can touch code”. The whole World Wide Web is founded on universal access. Making things means exploring, testing assumptions, screwing it up. That’s how we learn.

    For years, “this looks a little rough” was a decent proxy for “this was made by someone still learning, proceed with caution.” Sloppy code usually looked sloppy. But the clues that told us things weren’t working in the past are (almost) gone. What many AI tools produce is clean, conventional, reasonably well-structured code that works like magic.

    From convivial tool to … weapon of capitalism?

    For most of the twentieth century, things were built to be opened. You could pop the back off a radio, replace a tube, and figure out what was happening in there even if you weren’t the one who built it. Over time, that stopped being true.

    The Phoebus cartel famously agreed to cap lightbulb lifespans in the 1920s specifically to keep people buying replacements. Cars went from machines that a relatively handy person could tune up in their driveway to rolling computers that lock diagnostics behind proprietary tools. Farmers had to fight John Deere for the legal right to fix their own tractors, because the software wouldn’t let anyone but an authorized dealer touch it. The right-to-repair movement exists because manufacturers found that making things un-fixable was a durable business model.

    The philosopher Ivan Illich had a term for an alternative long before the advent of “smart” anything: a convivial tool, one people can understand, adjust, and repair themselves, versus an industrial tool that makes us dependent on someone else to keep it running. The internet of things pushed a lot of ordinary objects (thermostats, doorbells, light switches) into IP controlled territory. You don’t fix a smart lock. You wait for a firmware update, and hope the company still exists, or you replace the whole thing.

    The web was designed to be on the convivial side of that line. View source is right there in the browser. An entire generation of self-taught developers (Hello, world!) learned by looking at how other people’s pages worked, taking them apart, and making changes. That openness is why the web, like the printing press, was able to connect people and become a defining technological and cultural force.

    An AI-generated product you can’t read or maintain is problematic. In this case, it’s not that people sat down and decided to make plugins or apps un-fixable, but that’s a possible future when the barrier to producing drops at a speed well past comprehending what the heck you are doing.

    You may enjoy my article, “Harder, Better, Faster, Stronger: AI Anxiety Ain’t New“. Learn what “workism”, Lord Alfred Tennyson, and bananas have in common.

    Right now, a lot of AI tooling is priced like a loss leader. It’s cheap or free while companies fight for market share and habit formation. Once enough of us are building things we can’t maintain without the tool that built them, the pricing has room to move, and we won’t have much leverage. It’s not so different from the printer-and-cartridge model, or the appliance you can’t repair without the manufacturer’s proprietary part: the dependency is built in before anyone’s paying attention to what it’ll cost once we’re locked in.

    And I can’t leave this section without saying it: none of this is truly free or cheap. Every plugin an AI generates for you, every draft, every image — it’s not fluffy and weightless. It’s server farms, drinking water for cooling and burning power at a scale most of us never have to look at (yet). Read more about the energy use and climate footprint of big tech.

    With great power, comes great responsibility

    AI has genuinely expanded what a solo developer or a small in-house team can produce. That’s a tangible benefit, an objectively good thing. Someone with no coding background can now build a tool that solves a real life problem they have without a huge budget or a developer on staff.

    Between the eureka moment of “It works!” and understanding enough about how it works to be responsible for it, lies a world of complex unknowns.

    As I’ve said previously about web accessibility, ignorance of the law does not grant you immunity from its rules. Whether you are a developer, a volunteer, or a business owner — if you ship it to the public, you own it. Can your product or app be maintained by you, or is “ask the AI to fix it” the only path forward when something breaks? Does it work as intended for every visitor, not just the ones who are most like you? Does it meet whatever bar the project is held to — WCAG for a government or public-facing site, HIPAA-adjacent handling for a healthcare client, basic security hygiene for anything touching user data?

    Asking questions is still the strongest tool in your toolbelt

    This applies whether you’re evaluating a plugin from the WordPress repository or something you built yourself with an AI assistant. Before it goes live — especially in front of the public, or anywhere near sensitive data — ask:

    • Can someone here actually read and maintain this code? Can a genuine human on your team open the file, understand it, and change it without starting from scratch.
    • Has it been tested with a keyboard and a screen reader? Visual polish tells you nothing about whether it’s usable. Tab through it. Try it with a screen reader.
    • What happens when the person who built it moves on? If the answer is “no one else can touch it,” you don’t have a tool, you have a liability with a deadline.
    • Does it actually meet the compliance bar this project requires? A government contract, a healthcare client, an accessibility commitment — these aren’t optional extras layered on top of “does it work.” They’re part of what “done” means, and AI has no idea what your project’s specific obligations are unless someone tells it, checks its work, and keeps checking.

    These are the kinds of questions we ask ourselves as developers before shipping something. When AI makes it possible to sail past the friction of decision-making and still end up with something that looks finished, the burden is on us as creators to push back and do some due diligence.


    Featured image: A scene from ReBoot, an awesome Canadian animated series that was briefly on TV on Rochester, NY during my youth. Characters exist in the “mainframe,” a computer generated world, and had to keep the universe safe from the evil viruses known as Megabyte and Hexadecimal.

  • Web accessibility for small businesses

    Web accessibility for small businesses

    Many moons ago, I worked at an agency. Back then, the website development project was the hook. What we were really after was the monthly marketing and SEO engagement. Our websites were (initially, we got better at this) formulaic with no consideration for accessibility in our workflows.

    I could excuse this by saying, “Well, that was almost 10 years ago! So much has changed!”

    But, web accessibility isn’t new:

    The power of the Web is in its universality. Access by everyone regardless of disability is an essential aspect.

    Tim Berners-Lee, 1997, on launching the Web Accessibility Initiative (WAI)

    Has the profitable, commercial business of producing web product drifted so far from that noble venture of creating universal access to information? Or, are people doomed by their own peopley-ness, moved to act only when our individual needs and interests are affected?

    When we make something inaccessible, it’s rarely because we set out to exclude anyone. It’s usually because we didn’t think about it, because our own experience of the web felt like everyone’s experience. This complacency is a real problem. Not questioning our own internalized bias and assumptions, not considering experiences different from our own is harmful, whether or not that is our intent. People who are shut out by an inaccessible website don’t experience what we meant to do, they experience what we built.

    Digital accessibility is a critical knowledge gap for business owners and (still) a lot of developers and designers. Whether you decide to work with a developer or DIY your website, you need to know what to ask for.

    What is web accessibility?

    When I speak to new or prospective clients about web accessibility, most of them aren’t sure what that means or how it applies to their website project. In a recent conversation, a new client who had just launched a redesigned website, said simply: “Our previous developer never mentioned this.”

    Most of us associate the Americans with Disabilities Act (ADA) with physical spaces like ramps, automatic doors, accessible parking. Making digital spaces accessible is the same idea; websites should not create barriers for individuals with disabilities.

    Poorly designed websites can create unnecessary barriers for people with disabilities, just as poorly designed buildings prevent some from entering.

    Online Barriers, Archive, ADA.gov

    An accessible website works for people with a range of disabilities: someone navigating by keyboard instead of a mouse, a blind user relying on a screen reader to read page content aloud, a person with low vision who needs high contrast or larger text, or someone with a cognitive disability who benefits from plain language and consistent navigation.

    Web Content Accessibility Guidelines (WCAG), is built around four principles known as POUR: content must be Perceivable, Operable, Understandable, and Robust.

    1. Perceivable — including text alternatives for images, captions for video, and sufficient color contrast.
    2. Operable — navigable by keyboard, not dependent on a mouse or touch gesture.
    3. Understandable — clear language, consistent structure, forms that tell you what went wrong.
    4. Robust — built in a way that works reliably across different browsers and assistive technologies.

    ADA compliance vs. WCAG conformance

    These terms get used interchangeably, but they mean different things. The Americans with Disabilities Act (ADA) is a civil rights law that prohibits discrimination against people with disabilities and guarantees equal access to employment, public spaces, services, and information. It includes your entire business: your website, your PDFs, your email newsletters, your social media, your physical location. WCAG conformance is a technical standard applied to your website, or other digital materials, defining testable criteria for what makes web content accessible.

    While ADA doesn’t specify WCAG as an enforceable standard, U.S. Courts and the Department of Justice consistently use WCAG when evaluating whether a website meets accessibility expectations. The current minimum standard is WCAG 2.1, level AA. You don’t need to memorize the guidelines, but you should be aware that this is the benchmark your website needs to meet.

    But, my audience isn’t disabled

    More than 1 in 4 adults (28.7 percent) in the United States have some type of disability1.

    From a business perspective, can you afford to ignore almost 29% of the people you want to reach? And that’s before accounting for situational or temporary disabilities. A broken wrist, a migraine, age-related vision changes, a noisy environment where someone can’t play audio — these are situations that put anyone in the position of needing an accessible experience.

    Simply because an individual is a nonuser of accessible elements today does not mean that he or she will remain so tomorrow. In any given year, there is some probability that an individual will develop a disability (either temporary or permanent) that will necessitate use of these features.

    Alternate Scenarios, Title III Regulations Supplementary Information

    Web accessibility isn’t creating for a niche group of people, it is including your whole audience.

    I know accessibility matters, but do I “have” to do this?

    If you run a business that’s open to the public — which includes almost any business with a website — the answer is, “Yes, you have to do this”. Title III of the ADA applies to private businesses as places of public accommodation, and courts have consistently interpreted that to include websites.

    State and local governments have their own obligation under a separate section, Title II, and the Department of Justice issued a final rule in 2024 codifying WCAG 2.1 AA as the legal standard for government websites. Those compliance deadlines were extended in April 2026 — but some people argue that deadline is irrelevant. Your inaccessible website is excluding people today.

    Your website is part of your business, and your business has obligations under the ADA. There is no size exemption under Title III.

    About lawsuits

    Businesses can get sued over web accessibility. It happens more than you might realize, increasing 27% in 2025 from the previous year.

    The targets aren’t always large companies. Law firms, medical practices, restaurants, hotels, retail businesses, and professional services firms of all sizes have been named in ADA website cases.

    What tends to draw attention:

    • No accessibility statement. An accessibility statement signals that you’re aware of your obligations and have a process for addressing them. Its absence can signal the opposite.
    • Accessibility overlays. A site running an overlay signals that the underlying code hasn’t been addressed. Some users find overlays actively disruptive to their assistive technology, which creates additional grounds for complaint.
    • A broken or unusable experience for screen reader users. If a site is functionally unusable — no way to navigate, forms and tasks that can’t be completed.
    • Ignoring accommodation requests. If someone reaches out to tell you they can’t use your site, and you do nothing, that creates additional legal risk.

    If you’re ever in this position, documentation can help:

    Your goal is demonstrable, ongoing effort. Courts and plaintiffs’ attorneys look for evidence of good faith.

    • Document your work. Keep records of what accessibility decisions were made during development, any third-party audits you’ve commissioned, and any accommodation requests you’ve received and how you responded.
    • Have an accessibility statement on your site that describes your standards, your known limitations, and how someone can request an accommodation.
    • If you’ve had work done since launch like fixes, updates, improvements, make a note of that too.

    A formal third-party accessibility audit, conducted by a qualified evaluator, carries more legal weight than a developer’s self-assessment. It’s not cheap2, but if your site serves a large audience or you operate in a higher-risk category (healthcare, government-adjacent work, financial services), it’s worth considering.

    Who is responsible for web accessibility, you or your developer?

    Yeah, there’s a lot of people that ask me … ‘Should accessibility be its own thing? Or should it be a part of everybody’s job and something that everybody does?’ And they ask it like it’s an ‘or’ question; like it has to be one or the other. But it really should be both. Right? Like, accessibility should be part of everything, because it’s part of everybody’s job.

    Derek Featherstone, UX Podcast, “State of Accessibility“

    Your developer is responsible for building an accessible website. Accessibility involves technical decisions made throughout design and development, and a competent designer or developer should be treating it as an integral part of the work, not something to add at the end of a project.

    You, as the business owner, are responsible for the content you add after launch as well as for the website overall. If you upload a PDF that isn’t accessible, write a page with no meaningful heading structure, or post an image without describing it, that’s on you. More importantly: if someone with a disability can’t use your website, you are the one who can be sued3.

    If you have staff who add content to your site, they share that responsibility too. Training the people who maintain your content is part of maintaining an accessible website.

    If you’re working with a developer, here’s what to ask:

    • Are you building to WCAG 2.1 AA standards?
    • Will the site work for someone navigating by keyboard only?
    • Are you using semantic HTML; proper heading structure, labeled form fields, descriptive link text?
    • Will you do any accessibility testing before launch, and if so, how?
    • Can you add an accessibility statement to the site?

    A developer who can’t answer these questions clearly is a developer who isn’t building with web accessibility in mind (more about what to ask your developer in my Website Owner’s Missing Manual post).

    Progress, not perfection

    Say you have a website. Conducting an accessibility audit will produce a list of issues, an explanation of the failure, and recommendations for remediation.

    Types of accessibility audits

    • Automated scanning – Automated tools can crawl your site and flag common issues. It’s fast, it’s a useful starting point, and it catches roughly 30 percent of accessibility problems. The other 70 percent require human judgment.
    • Manual evaluation – A trained evaluator navigates your site using a keyboard and screen reader software, reviews your code, and identifies structural problems that automated tools can’t detect.
    • Evaluation by disabled accessibility professionals – Professional expertise combined with the lived experience of navigating the web with assistive technology every day.

    The audit report also shows that you engaged a qualified professional, identified issues in good faith, and had a remediation plan. If you ever receive a demand letter, this can be very helpful documentation.

    Remediation: after the audit

    An audit tells you what’s failed the standard. Remediation is making changes that remove barriers and allow you to meet the WCAG success criteria.

    Remediation work should be prioritized because not every issue is equally important. A missing form label that prevents a screen reader user from completing a contact form is more urgent than a color contrast ratio that’s slightly below threshold on a decorative element.

    After remediation, retest.

    Remediation isn’t a finish line. Websites change — you add pages, update content, install new plugins. Regular accessibility testing should be part of how you maintain your site, the same way you update software, check for broken links, or monitor your search performance.

    Caveat: no website is 100% accessible

    No evaluation process, and no website, can be perfectly accessible for every person in every situation. Disability is not a single, uniform experience. Accessibility is ongoing work. Build with accessibility in mind, test what you can, respond to feedback, and keep improving.

    Do we need a law to do the right thing?

    The Americans With Disabilities Act was signed into law in 1990 after more than a century of activism by people with disabilities who were excluded from spaces built without them in mind. The law exists because too many people and institutions needed to be required to care.

    Web accessibility is a founding principle of the internet, we should treat it as an essential requirement in our work designing and developing websites for people. Part of this work as developers and content creators is to keep learning, expanding our understanding of our roles, and doing what we can do to make the world (and the web) a little better.


    1. CDC Data Shows Over 70 Million U.S. Adults Reported Having a Disability ↩︎
    2. You can also claim the Disabled Access Credit on your business taxes for eligible expenses. ↩︎
    3. For any developers reading this, it’s also worth knowing that agencies have been named as co-defendants in accessibility lawsuits alongside the businesses they built for. Building accessible websites isn’t just good practice, it’s professional protection. ↩︎
  • Picture Perfect: The Art of Accessible Images (& PDFs)

    Picture Perfect: The Art of Accessible Images (& PDFs)

    Making the Most of Images and PDFs: A Guide to Accessible Visual Content

    Strategic use of images enhances web content by breaking up text blocks, increasing engagement, and providing visual interest. While images create a better experience for sighted users, properly crafted alternative text (alt text) ensures accessibility for those using screen readers or assistive technologies. Alt text benefits everyone – when images fail to load due to slow connections or offline viewing, this descriptive text maintains context and meaning. Alt text also helps enhance search engines’ understanding of your content.

    What is Image “Alt Text”?

    Well-crafted alt text is essential for ensuring web accessibility and usability. The best alt text takes into consideration the context of the image along with its purpose.

    NN/g, “Alt Text: What to Write“

    If an image is used to help people to complete a task or understand page content, it needs alt text. This alternative text attribute, or “alt text,” is a text substitute for images, graphs, videos, and other visual (non-text) elements. Alt text should:

    • Tell people why the image is there based on context
    • Be concise and describe the essential information about the image. This is not a place for marketing copy or keyword stuffing
    • Explain the image in a meaningful way, as if to a friend
    • Watch out for and avoid overly long alternative text

    You do not need to include words like ‘image’ or ‘photo’ at the beginning of alt text. Screen readers will identify images based on their <img> tag. Learn more about writing helpful alt text.

    Is the image merely decorative?

    Alt text is not necessary for images that are purely decorative. If a text description doesn’t provide context or meaningful information, don’t add it. Unnecessary alt text is verbose and annoying.

    Alt Text and Search Engine Optimization

    Including keywords in alt text can also be beneficial for SEO. Those text descriptions also help search engines understand your images. It is important to balance your optimization efforts with providing accurate, descriptive information about your images.

    Avoid Keyword Stuffing

    Keyword stuffing in alt text is considered a poor practice and can negatively impact your SEO efforts:

    • Google explicitly warns against filling alt attributes with keywords, as it may cause your site to be seen as spam.
    • Overusing keywords can detract from user experience, especially for those using screen readers

    Use keywords appropriately and in context, without compromising the primary function of alt text, which is to provide accessibility with clear, concise image descriptions.

    Images of Text

    While images containing text remain popular for social media and web content, they often create accessibility barriers. Although tools like Canva make it easy to create visually appealing designs, these graphics typically aren’t accessible by default. Instead, modern CSS and responsive design techniques allow developers to create sophisticated visual effects – like text overlays on images – that maintain accessibility while achieving the same aesthetic impact.

    Use actual text instead of images containing text wherever possible on your website.

    • Text embedded in images cannot be read by screen readers or search engines. This content is inaccessible to users with visual impairments and search.
    • Text in images doesn’t scale well on mobile devices or when users zoom in, potentially becoming illegible.
    • Text over images often lacks sufficient color contrast and is difficult for users with low vision or color blindness to read.
    • For complex images like infographics, offer a text-only HTML version that captures all essential information.
    • For essential images of text, like scanned documents, offer text-based alternatives.

    I get it – images of text dominate social media feeds. They grab attention and add visual impact to your message. But don’t let style override accessibility: pair that spiffy design with clear, descriptive alt text so everyone can engage with your content.

    Infographics

    Creating accessible infographics begins with clear, concise content that breaks down complex information into digestible chunks without jargon.

    Information should follow a logical structure with proper headings and subheadings to guide understanding. To ensure all users can access your data, provide alternative formats such as downloadable tables or plain text summaries alongside the visual representation.

    • Keep layouts clean and uncluttered.
    • Avoid excessive animations or effects that might distract users.
    • Ensure text and graphics meet WCAG contrast requirements.
    • Use easily readable sans-serif fonts, and avoid small text sizes.
    • Clearly label all visual elements, including axes, data points, and legends in charts and graphs to enhance comprehension for all users.
    • Use semantic HTML elements to structure web-based infographics.
    • Ensure keyboard navigation for all interactive components, and provide comprehensive alt text for images and graphs.
    • When using tables, implement proper HTML table elements with appropriate headers and captions.
    • Offer text transcripts that provide full descriptions of the infographic’s content for users who rely on screen readers or other assistive technologies.

    Creating accessible infographics helps make the content usable and understandable for all users, including those with disabilities.

    Should I use a PDF?

    Good structure matters everywhere – whether you’re creating webpage content or PDFs, using proper headings, organized lists, and clear document hierarchy helps make your content accessible to all users. But the question remains: which format best serves your content and audience?

    • Adobe Acrobat Pro can check accessibility in a PDF
    • Using Word to create a PDF is probably your best bet
    • PDFs created in Canva or other design programs are likely NOT accessible by default! You can check and remediate PDFs in Adobe Acrobat Pro.

    PDFs vs. Modern Web Capabilities

    The PDF (Portable Document Format), created by Adobe in 1993, was designed to display documents consistently across different devices and operating systems. When PDFs first emerged, creating sophisticated website designs was nearly impossible without heavy reliance on images and tables, and browsers displayed content inconsistently. Today, modern CSS and improved browser interoperability allow for rich, accessible web-based experiences that are equal to or better than the formatting control enabled through PDFs.

    Consider PDFs when:

    • Your content requires specific formatting that can’t be replicated on a webpage
    • Users need offline access to downloadable documents
    • PDFs work well for printable forms, annual reports, or documents with complex layouts that must remain static.

    For most web content, however, inline text is the better choice. Inline content improves searchability, simplifies updates, adapts to different screen sizes, and enhances accessibility. It also helps maintain website performance by avoiding the additional load time of PDF files. Before automatically reaching for a PDF, ask yourself if your content could work just as well – or better – as standard webpage text.

    Create More Accessible Content, Starting with Your Next Image

    Making your content accessible isn’t just about compliance – it’s about creating an inclusive digital experience that serves all users effectively. Take time to write descriptive alt text for your images and carefully consider whether your content belongs in a PDF or inline on your webpage. Small changes in how you handle these elements can make a significant difference in user experience.

    Ready to improve your content accessibility? Start by auditing your existing images and PDFs. Update alt text on key images, and identify which PDFs could work better as inline content.

    Accessibility tools and resources

    Need help getting started? Download our accessibility checklist or reach out to our team for a content accessibility review.