How to Write a Clear Tech Support Request

A clear tech support request helps another person understand what went wrong without having to reconstruct your entire workday. You do not need technical vocabulary. You need a specific description, a few useful details, and a clear distinction between what you observed and what you suspect.

Describe the task before the problem

Begin with what you were trying to do. “I was uploading a PDF to the customer portal” gives more context than “The website is broken.” Then explain what happened instead. Mention whether the page froze, an error appeared, or the upload finished but the file could not be opened.

Include the exact error message when possible. A short quotation is more useful than a paraphrase such as “something about access.” If the error contains an account number, access token, or other private information, remove that detail before sharing it.

Provide the minimum useful environment details

Identify the device type, operating system, browser or app, and relevant version if you can find it easily. Explain whether the issue affects one file, one account, or every attempt. These details help support staff narrow the scope.

• What were you doing immediately before the issue?
• When did it happen, including the time zone?
• Does it happen every time or only sometimes?
• What troubleshooting have you already tried?
• How is the issue affecting your work?

Make the steps reproducible

Write a numbered sequence with only the steps needed to trigger the problem. For example: open the portal, choose Upload, select the file, and press Submit. Then state the expected result and actual result separately. If the same steps sometimes work, say so.

A screenshot can help when layout or a visible message matters. Crop unrelated content, hide private customer information, and check browser tabs or notifications before sending. Never include passwords, one-time codes, recovery codes, or secret keys in a support ticket.

Use a compact request template

Subject: PDF upload fails after pressing Submit

Task: Uploading a PDF to the customer portal.
Observed result: The page shows the quoted error below.
Expected result: The file appears in my documents.
Scope: Happens with two PDFs in the same account.
Already tried: Signed out and back in.
Impact: I cannot complete today's document submission.

Keep guesses separate from facts. “This started after an update” is an observation about timing. “The update caused it” is a conclusion that still needs evidence.

Frequently asked questions

Should I send a video?

A short recording may help with an intermittent interaction. Check it for sensitive information and use the support team's approved upload method.

What if I cannot reproduce the problem?

Report the approximate time, the last action you remember, and how often it has happened. Incomplete but accurate information is better than invented certainty.