Page tree
Skip to end of metadata
Go to start of metadata

Keep UI language brief and be specific. It's OK to rely on the user's common knowledge - don't state the obvious.

App name

Name your app for its intended use. Be specific.

Guideline(tick) Good(error) Poor
Short, 2 x 12 characters max.PagesWeb Page Editing
Be unique, avoid repeating Magnolia native app namesCampaignsPages (campaigns)
Use friendly language, avoid technical termsFeedsRSS Aggregator
Be specific, one task per appGoogle SitemapsGoogle Tools

The app name is displayed under the icon in the app launcher. Short names that fit on one line work best.

Field labels

A field label states the purpose of a field. Good labels are short and clear. The label is displayed to the left of the field in left-to-right languages.

  • Always visible
  • 17 characters max. Longer labels wrap to the next line.
  • One or two words

Field descriptions

A field description explains what a field is for and may shortly explain why the data is collected. Field descriptions are a form of context-sensitive online help.

  • Displayed when the user clicks the question mark. 
  • 80 characters max. Longer descriptions wrap to the next line.
  • Use for:
    • Fields that expect input in a special format, such as ZIP codes or credit card numbers.
    • Unusual fields whose input is not common knowledge, such as metadata. 
    • Informing the user about best practice such as fields that have a significant impact on SEO.

(warning) Avoid useless descriptions that just add visual noise. When a field is common knowledge, such as "First name", you don't need a description.

Dialog descriptions

You can also add a description to the dialog itself. For example, when a dialog collects private data, link to a privacy policy so the user understands that their data remains safe.

  • No labels