In a perfect world, you’d never need to submit a bug ticket. Everything would work perfectly 100% of the time. Unfortunately, we don’t live in that world. When something isn’t working, you want it fixed pronto. Here’s how to make that happen.

Submitting a solid bug ticket can cut down on the back-and-forth email rigamarole you’re probably all-too familiar with. Sharing the right information in your bug ticket upfront will help your developer identify and resolve the problem swiftly, meaning you can get back to work, safe in the knowledge that we are fixing your issue. By the end of this post, you will be fluent in bug ticket and free to get back to your real work!

Bug tickets done right = your key to a speedy website repair.

Like all problems, the best starting point is to articulate what the problem is. The more details you can provide, the better. Don’t worry about oversharing. We will take all the details you can offer, and we will use that information to prioritize our theories and investigations.

Imagine we are blindfolded and you are explaining what you see and experience step-by-step to us. The result is a comprehensive, clear explanation of the issue plaguing your website.

Structure helps too. Here are the key details we need from you to get started without having to reach out with questions. If you want to get super fancy, you can follow the structure below.

Bug ticket key information:

The tech details:

  • Mobile or desktop?
  • If mobile, what kind of phone?
  • Operating system (Mac or PC) and version
  • Browser type (Safari, Chrome, Firefox, Internet Explorer) and version

The steps that resulted in the issue:

  • Walk us through it step-by-step.
  • What had you been trying to accomplish, and what was the outcome?
  • List the pages or links on which you found errors.
  • Cite any content, images or forms missing, if known.
  • Include any error messages you picked up along the way.

And finally:

  • Screen shots!

If you can take a couple of images of what you see, attaching those will literally save you a thousand words. Need a hand? Ping us and we will help!

The more complicated the website, the more errors you can expect.

A good bug ticket looks a little like this:

  • Browser: Google Chrome 63
  • Operating System (OS)/Device: Mac OS X10.9, iMac 7
  • Reproduction: Tried to purchase two items, click checkout. No confirmation message or email sent. Small one line error message received at top of page. Checked credit card — all valid.
  • Problem: The purchase won’t go through, despite repeat inputs. It just goes back to the original payment input screen.

In the case above, it could be a setting in the payment processor that is causing the problem (for example, expiration date settings), or perhaps a coding issue following a software update. We’ll get to the bottom of it, based on the information you provide.

While we’re here, why do websites break?

You’ve spent a pretty penny on a slick new site, with lots of clever functionality coded by an experienced team. Shouldn’t it just work?

Truth time. You can expect anywhere between 15 to 50 errors per 1000 lines of delivered code — that’s the industry average. And that’s with a QA process. We’re scarily devoted to precision and perfection, but the truth is that some projects simply don’t have the scope to “unit test” every piece of code.

The more complicated the website, the more errors you can expect.

A lot of things can cause your website to malfunction. We’re talking beyond your website going down because of hardware, hosting, denial of service (DoS) attacks, or DNS issues.

Read more: Why You Need to Provide Feedback at Every Stage of a Project >>

Some typical issues that can lead to busted functionality:

  • A change in one style rule that breaks code elsewhere
  • Miscommunication in expectations or functionality wants
  • Operating system or web browser updates
  • Third-party software breaking or changing without notice
  • Plugins or platform updates or changes
  • Hosting or open-source platform changes
  • Database errors causing page loading issues
  • Gremlins (They’re definitely real)

It’s inevitable that every now and then, something will go janky on your site. Even if Big Sea builds it. The good news is that we love a good challenge, and with your bug ticket skills and our code prowess, you’ll be back in action in no time.