Debugging Your Design

When we have our “developer hat” on, it’s natural to debug problems step by step. If something isn’t working, we quickly make a mental list of the possible causes and test them …

Published:

Filed Under:

Kyle Van Deusen

The Admin Bar

After spending 15 years as a graphic designer and earning a business degree, I launched my agency, OGAL Web Design, in 2017. A year later, after finding the amazing community around WordPress, I co-found The Admin Bar, which has grown to become the #1 community for WordPress professionals. I'm a husband and proud father of three, and a resident of the Commonwealth of Virginia.

debugging designs

This content contains affiliate links. View our affiliate disclaimer.

When we have our “developer hat” on, it’s natural to debug problems step by step. If something isn’t working, we quickly make a mental list of the possible causes and test them one by one until we find the solution.

But when we have our “designer hat” on — the same methodology isn’t quite as intuitive (at least not for us untrained designers).

I can’t tell you how many hours I’ve wasted just moving things around on the page aimlessly hoping it will all of a sudden “click” and all come together. Sometimes I get lucky, but most of the time I just get frustrated.

Design is part art, where subjective factors (like finding the right blue that’s blue enough, but not too blue) play a role in our opinion of a design.

But it’s a science too, where objective factors (like space, contrast, alignment, and hierarchy) actually play an even more important role than your taste.

When you realize this, you can use it to your advantage to help “debug your designs” just like you would any other problem.

To do this, you need to examine the possible causes your design just isn’t working. Things like:

  1. Contrast – Is there enough? Is there too much? What is providing contrast (colors, sizes, spacing)?
  2. Scale, Proportions, & Proximity – Take a look at each element…Is it too big? Too small? Are related elements closer together than non-related ones?
  3. Color – How is color helping to guide people’s attention? Is the color consistent with the design?
  4. White Space – Try squinting your eyes — are things running together, or clearly separated? How much more space can you add until the design “breaks”?
  5. Alignment & Spacing – Is everything properly aligned on an established grid? Is the spacing consistent and appropriate?

It’s important to not look at a design or layout as “one thing” — it’s a lot of little things that are either working harmoniously or fighting with each other.

By examining these things one-by-one, you can quickly debug what’s wrong with the design (objectively) and improve it drastically.

Ask yourself “What are the possible reasons this is not working?” and run tests on all your hypotheses until you find the answer(s).

If you want to put your debugging skills to the test and practice this approach, check out this interactive game by Gary Simon at DesignCourse.com which tests you on things like color, white space, typography, scale, contrast, alignment, and visual hierarchy.

If you try it out, reply with your score and let me know how you did!

Was this article helpful?

Kyle Van Deusen

The Admin Bar

After spending 15 years as a graphic designer and earning a business degree, I launched my agency, OGAL Web Design, in 2017. A year later, after finding the amazing community around WordPress, I co-found The Admin Bar, which has grown to become the #1 community for WordPress professionals. I'm a husband and proud father of three, and a resident of the Commonwealth of Virginia.

Use of AI: AI helps me outline, research, catch typos, and find better words & phrases. I take full personal responsibility for all my published content (the good, the bad, and the em dashed).

Come Join Us!

Join the #1 WordPress Community and dive into conversations covering every aspect of running an agency!

Kyle Van Deusen

Community Manager

Latest Events

July 27th

The $30,000 Mistake Hiding in Your Cookie Banner

A Live CIPA Training for WordPress Agencies, with Termageddon's Hans Skillrud

July 16, 2026

You Don’t Have to Leave WordPress to Work With AI

AI and WordPress don't have to be at odds. See how InstaWP's MCP connects WordPress to the AI tools you're already using — live demo, real Q&A, and a real answer to the security question.

June 18th, 2026

WP Umbrella’s Biggest Evolution Yet

Join Aurelio Volle for a live walkthrough of WP Umbrella V3 — new dashboard, bulk views, backup engine, and more. June 18th at 12:30pm Eastern.
Tpdc onblue

Learn a proven discovery framework to transform casual leads into high-paying clients.

View the Course
The Friday Chaser

Wash down the week with the best of The Admin Bar! News, tips, and the best conversations delivered straight to your inbox every Friday!

More Articles

Robotic hand holding a magnifying glass, symbolizing AI and technology analysis.

How to Run AI Visibility Audits & Sell Them as a Service

Agency owners and web designers: should you offer an AI visibility audit? See what to include, how to package it, handle objections & turn it into paid work.

Rachel McFadden smiling with hand on chin, wearing a blue blouse, sitting on a pink chair.

Member Spotlight: Rachel McFadden

Before Rachel McFadden was building websites, she was a civil engineer and construction project manager (which …

Illustration of an email envelope icon with a yellow background and black outline.

The Best Email Hosting for Web Agencies and Their Clients

WordPress agency owners share where they actually host email — and what they’ve learned to avoid along the way.