Guide · Item pages

Writing a good item page

The person reading your page is standing in front of the item, with a phone in one hand and maybe a bag or a child in the other. They want to know what it is, then one thing worth knowing about it, in about a minute.

Put the name and the facts first

  • Name: the name people use, as it would appear on a sign. For a tree that might be "Olive tree"; the scientific name goes in its own field.
  • Summary: one sentence, up to 200 characters, shown under the name and in search results. Say what makes this item different from the one next to it.
  • Fields: the item's category decides which fields it has, such as a plant's origin or a machine's muscle groups. Fill in what you know. Fields you leave empty don't appear on the page.

Keep the story short

The story is the text under the facts. Write it for the place, not for a book:

  • Lead with the most interesting thing. The first two lines are often all people read.
  • Use short paragraphs and plain words. If a term needs explaining, explain it in the same sentence.
  • Three or four paragraphs are plenty. A page that fits on two phone screens gets read to the end.
  • For a machine or a device, put safety and how-to-use first, in a list.

The editor has a toolbar for headings, bold, lists and links, so you don't need to know Markdown.

Choose the photos

  • The first photo is the one at the top of the page. Drag the photos into the order you want.
  • Show the real item in place, in daylight, then the details: a flower, the bark, a control panel.
  • Each item can have up to 5 photos on the free plan, and more on paid plans. JPEG, PNG and WebP files up to 10 MB are accepted and resized for phones automatically.

Add files if they help

Attachments are files visitors can download, such as a care sheet or a machine's manual. Use them for things people want to keep, not for text that belongs on the page.

Write in two languages

On Pro and above, each page can have a second language. Visitors see the page in their phone's language when you've written it, and can switch. Where a translation is missing, the page shows your primary language.

Draft, publish, and keep it up to date

A new item starts as a draft. Its page goes public when you choose Publish, and changes to a published item go live when you save. You can edit a page as often as you like: its address and its label stay the same.

Check it on a phone

Choose View page to open the public page, or scan the item's label. Read it standing up, the way a visitor will.

Cookie settings

Essential cookies keep our pages working. Choose whether we may also use the others. You can change this at any time.