Skip to content
Interface language: English
Design / Signal

Product instructions on a website: first use without guessing

Prepare first-use instructions with the correct version, sequence, images and a way to check the result.

Article language: English

A woman examines a white petal-shaped object near a cat and lights.
In this article

The box is open. Every part looks familiar except one that clearly looks important. The product page has a beautiful description of the idea, three interior photographs and a download button for “Instruction_final_corrected_2”. Right now the customer needs a much smaller answer: where to begin so they do not have to lay everything on the floor a second time.

First-use instructions should take a person from the received product to a first recognisable result. They need not contain its entire history or replace the manufacturer's complete documentation. They should identify the right variant, preparation, sequence and a way to check whether the important stage succeeded.

Consider a fictional desk organiser: a base, two dividers and an insert for small objects. It is simple, with no electrical installation or tasks requiring special qualifications. This is a convenient editorial example. For a real product, the person responsible must approve technical content, warnings and permitted use. The website designer arranges that knowledge into a readable path.

Start at the box, not the company drive structure

Before writing, reconstruct the first encounter. What is in front of the person? How do they recognise the model? Which parts look alike? Does the packaging name match the product page? If an internal catalogue code is needed just to find instructions, first improve the identification path.

For our organiser the opening could show the set laid out on a light background and name the three kinds of part. The quantity belongs beside each name. An elegant drawing alone does not establish whether the second divider was lost or never belonged to this version.

State which variant the instructions cover. Base size or fastening may distinguish two almost identical versions. Do not let the customer begin only to discover the difference at step six. If one document covers several versions, explain the route choice at the beginning and label later differences consistently.

Part names should match the box and drawings. “Strip”, “divider” and “support” may mean the same part in the team's conversation, but a beginner does not know that. Choose one term and, if useful, a code. The code helps identify the part; the name explains its role.

List what is needed before starting. In our example that is clear table space and checking the set's contents. Preparation may differ for another product. Do not copy a tool list from a similar job. Every item must follow from the approved procedure.

Also say when to stop. If a part does not fit the illustrated variant or something is missing, the reader should know how to obtain clarification. Instructions cannot assume every obstacle should be overcome with greater force and still greater trust in an illustration.

Finding the material is part of the design. If linking from the package or paper insert, check the QR code's destination (in Polish), including the correct instruction variant. A link can appear on the product page, in help and in a post-purchase transactional message (in Polish). Each path should reach the right version. People often return much later without remembering which message contained it.

Do not require order details again merely to read public instructions. If material needs a different access method, explain it clearly. The customer should understand how to reach the knowledge before diagnosing the product.

Set out the first three actions

A working version for the fictional organiser might read:

  1. Check the contents against the picture. The set should contain a base, two identical dividers and one insert.
  2. Place the base on the table as shown in the drawing. The front marker should be on the illustrated side.
  3. Put the first divider in the marked position. Compare its position with the completed-stage view before adding the second.

This illustrates writing, not instructions for an existing product. Each step has an action and a check. Real material needs approved information arising from its construction. Separating the two makes a gap easier to see: the reader may know what to do but still not know whether it was done correctly.

WordPress editorial guidance on procedures recommends following execution order and ending with a defined action or result. These are rules for that platform's documentation. For a physical product we use only the clear-sequence principle; the substance of each action remains the manufacturer's knowledge.

Do not combine several independent actions in one long step. If a reader puts the phone down, acts and returns, they should find their place easily. Conversely, splitting every tiny movement onto another screen can make the whole harder to understand. The boundary is a stage that can be recognised and checked.

Plan a return after a break too. A stage name and view of the current state let someone recognise whether the first divider has already been added. A list of stages may help in a longer procedure, but should not imply completion of actions the system does not observe. Opening the next paragraph does not prove work on the product was done. Progress indication should help the reader, not create false confirmation.

Place the expected result where it is needed. “The divider should be in the position shown” beside the right image helps immediately. A general “After correct assembly the product is ready” at the page end does not help locate a mistake made minutes earlier.

Aeneia conceptual photography

The image must show the action described by the text

An opening photograph can show the finished organiser in use. A step needs another frame: the right part, connection point and orientation. Do not treat instructional pictures as rejected campaign photographs. They have their own job.

Keep a clear reference point between shots. If the product suddenly turns half a rotation, mark the change or show a wider view. The author knows the object and can reconstruct orientation easily. The reader may be holding the base backwards while comparing two similar holes.

iFixit's guide-step help says a step title should explain its content and image markings can be connected to corresponding text points. This is an example of coherent instruction elements. You need not copy its specific colours to apply the relationship in your own material.

If using markers, keep their meanings. An arrow indicating motion should not indicate an arbitrary detail in the next picture. A part number must not compete with a step number. During acceptance ask someone outside the project to identify what each marker refers to before acting.

Colour can support distinction, but add a name or number in text too. “Insert the green-marked part” depends on perceiving colour. “Insert divider A at position A” gives another identification route. Check the markings in print too if the manufacturer expects that use.

On a phone, show detail at a readable scale. A high-resolution file is not enough if the page displays it as a narrow strip. Magnification should allow return to the same step. After viewing a detail, the reader should not land at the beginning of the whole guide.

A short film helps when meaning lies in motion. Allow pausing and finding the important moment. An ordinary written action still helps people return to a step without watching everything again. Consider embedding video on a service page (in Polish), particularly when material will be used on a narrow screen.

Choose publication format for the situation. HTML supports direct links to content and an adaptable view. PDF may meet a need to download or print but requires its own preparation. When choosing PDF or HTML (in Polish), do not assume that adding any file completes the instruction design.

If providing both, establish a shared source or update procedure. Two separately maintained materials can easily diverge after a component changes. The customer should not have to decide whether the date on the page, file name or picture in a message is more current.

For a website project, Aeneia Design can help give approved materials a clear structure and place in the customer journey.

Check the instructions against a real task

For the test also prepare a mismatched instruction version and see whether a participant recognises the difference before starting. There is no need to perform an incorrect action. Ask them to choose the right material using the product marking. This reveals whether version names and opening images actually protect against confusion or merely look good next to each other in the catalogue.

The test needs a product or credible representation of the actions, current instructions and a person with experience similar to the future audience. The author should observe. If they spend the entire time explaining where to look, they are mainly testing their own patience, not the instruction's independence.

Record stops: an unidentified part, unclear frame, missing confirmation or trouble returning to a step. Do not call every pause an error. A person may simply be carefully comparing the image with the object. A problem begins when the material does not provide the needed answer and the person must guess.

After a stage, ask how the participant recognised success. If the answer is “it looked more or less right”, check whether the instructions show a sufficiently concrete result. Do not immediately add another warning. A better view of the completed connection or a simpler part name may be enough.

Separate lack of knowledge from a language problem. If an action requires specialist preparation, prettier text will not replace it. If the reader does not understand a word used only internally, improve naming. In the brand voice of interface messages (in Polish), helping with the task also takes priority over decorative expression.

Trial questions can enter an FAQ (in Polish), but do not hide a basic action in an answer at the bottom. If several people ask which way to orient the base, fix the relevant step. Expanding a list of frequent questions should not replace repairing the instructions.

Finally, appoint an owner and reasons for review. A new product version, changed set contents or different part marking should trigger an instruction check. Record model, version and approval date somewhere that distinguishes current material from old. “Final” in a filename expresses hope, not a versioning system.

Good instructions allow someone to start, stop and return without reconstructing the whole history. After first use they may be needed again for another question. Clear stage names and a stable publication location then prove as useful as a carefully prepared opening frame.

Aeneia / Aeneia editorial

Editorial article. Source links are included in the text.

About Aeneia

Brands we have worked with

  • L’Oréal
  • Garnier
  • Netflix
  • Carrefour
  • Warner Bros. Discovery
  • Biedronka
  • HBO Max
  • Wolt
  • Żabka
  • COSRX
  • Embassy of China in Poland
  • Mixa
Aeneia / Initium

From knowledge to a decision

Tell us what you want to put in order. We will agree on where to start.

Contact Aeneia

We partner with and use solutions from:

  • Google
  • OpenAI
  • Microsoft
  • Stripe
  • Anthropic
  • Linear