Menu
Feedback
Guides
Interface copy
General
Titles
Titles

Titles consist of up to three words to name the content of a page or a specific section within it. This pattern is commonly used in components like Modals or Tabs.

General

Use sentence case but capitalize proper nouns.

Do ✅Don't ❌
  • Give feedback
  • Help Center
  • Give Feedback
  • Help center

Don't use punctuation, such as question marks or periods.

Do ✅Don't ❌
  • Page not found
  • Delete user
  • Page not found.
  • Delete user?

Avoid using articles.

Do ✅Don't ❌
Add new sellerAdd a new seller

Don't use personal pronouns.

Do ✅Don't ❌
Application keysMy application keys

Keep it as short as possible while still being descriptive enough.

Do ✅Don't ❌
  • Inventory
  • Campaigns
  • Inventory management
  • Store promotional campaigns

Avoid redundancy, such as by omitting context present elsewhere.

Do ✅Don't ❌
  • Page title:

    Products

  • Titles inside page:

    Products

    Categories

  • Page title:

    Permissions

  • Titles inside page:

    Product permissions

    Category permissions

Don't use a marketing tone of voice.

Do ✅Don't ❌
  • Search
  • New product
  • VTEX Intelligent Search
  • Quickly create a product

Specific

Page

Reuse the same page title whenever possible, such as in the URL, title meta tag, and, when it applies, in a navigation entry.

Do ✅Don't ❌
  • Page title: Orders
  • Title meta tag: Orders
  • URL: /orders
  • Navigation entry: Orders
  • Page title: Orders
  • Title meta tag: Orders listing
  • URL: /all-orders
  • Navigation entry: Store orders

In a form page, when an item is being edited, use the name of the item as the page title. When a new item is being created, use the word New followed by the item type.

Do ✅Don't ❌
  • Christmas discount
  • New promotion
  • Promotion
  • Untitled promotion

In a listing page, use the type of item being listed as the page title. Include only nouns in the plural form and avoid adding an unnecessary prefix or suffix.

Do ✅Don't ❌
  • Product
  • Orders
  • All products
  • Orders listing

In a modal with a form or actions, use an action label as the title. If the modal was triggered by action, prefer to repeat the verb of the action that triggered the modal.

Do ✅Don't ❌
  • Delete shipping policy
  • Create release
  • Shipping policy
  • Create
Contributors
1
Photo of the contributor
+ 1 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Placeholder texts
« Previous
Data formats
Next »
Contributors
1
Photo of the contributor
+ 1 contributors
On this page
GithubCommunityFeedback