Black Friday

Check out our Black Friday deals page, packed with over 100 of the biggest discounts on your favorite WordPress products!

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

Best Backup Tool for WordPress Websites

WordPress agency owners share how they back up client sites, how many layers they run, and the uncomfortable question most of them admitted they haven’t fully answered: do the restores actually work?

Person leaning toward a laptop screen in dim blue lighting, suggesting online research or focus.

Designing Your Own Website for Your Agency? Maybe Don’t.

Designing your own website? Here’s when agency owners should stop fiddling, bring in fresh eyes, and hand the job to someone who isn’t quite so close to it.

Best Membership Plugins for WordPress

WordPress agency owners share the membership plugins they build with, why support matters more than features, and the pricing worry hanging over one of the biggest names.