How to Report a Website Problem: 6 Details That Help Support
What should you send when a website feature stops working? A clear report helps support reproduce the problem and investigate.
1:47 · No narration: the video shows each step as text on screen, and every step is written out below, with buttons that jump the video to it.
Prefer YouTube? Watch this video on our YouTube channel (opens in a new tab).
The six points in the video
This is a silent video. The headings, explanations and labels below reproduce the information on screen.
-
Step 1: Name the page and the task
Include the page address and what you were trying to do.
On-screen labels: Page address; Intended task; Affected feature.
-
Step 2: List the steps in order
Describe the actions needed to reach the problem.
On-screen labels: Starting point; Actions taken; Problem step.
-
Step 3: Compare expected and actual
Explain what you expected and what happened instead.
On-screen labels: Expected result; Actual result; Visible error.
-
Step 4: Include the useful context
Give the time, browser and device where you noticed it.
On-screen labels: Browser and device; Time observed; Repeatability.
-
Step 5: Share appropriate evidence
A screenshot can help; remove passwords and private customer details.
On-screen labels: Relevant screenshot; Exact error text; Sensitive details removed.
-
Step 6: Explain the customer impact
Say which task is blocked and whether a workaround exists.
On-screen labels: Affected visitors; Blocked task; Available workaround.
A practical check for your business
Report the address, attempted action and observed result without including unnecessary personal information. A reproducible example, device details and time can help the maintainer investigate a specific problem.
Sources and further detail
Common questions
What should you send when a website feature stops working?
A clear report helps support reproduce the problem and investigate. Describe the task, the result and the evidence.
Go further
More video tips
All 205 videos →
Git vs GitHub: Version Control and Collaboration Explained
Version control and collaboration.
What Is a Code Repository? A Website Handover Term Explained
A repository, explained.