Menu
Feedback
Guides
Grammar
General
Verbs
Verbs

Verbs play a critical role in creating clear and actionable content for user interfaces and documentation. They guide users, convey actions, and ensure instructions are concise yet effective.

Documentation

Start sentences with imperative verbs when indicating the actions users must take.

Do ✅Don't ❌
  • Create a Catalog for populating and testing your store with features like product listing pages, search functionality, product detail pages, and checkout.
  • Open the VTEX Admin and access Storefront > FastStore WebOps.
  • Enter your postal code.
  • Learn more about VTEX IO Clients and their advantages.
  • To populate and test your store with features like product listing pages, search functionality, product detail pages, and checkout, create a catalog.
  • At the VTEX Admin, access Storefront > FastStore WebOps.
  • Entering your postal code.
  • Learning more about VTEX IO Clients and their advantages.

When the title or heading starts with a verb, use it in the -ing form.

Do ✅Don't ❌
Creating a specification group in a categoryCreate a specification group in a category

When introducing sections with the phrase you can: at the beginning of an article, use the infinitive, but use the -ing form in the actual heading.

Do ✅Don't ❌
In this guide, you will learn how to:
  • Access Media
  • Manage files in Media

Accessing Media

There are three ways to access Media:

In this guide, you will learn how to:
  • Accessing Media
  • Managing files in Media

Access Media

There are three ways to access Media:

When talking about a description in a table, use the present.

{"base64":"  ","img":{"width":1436,"height":726,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":122600,"url":"https://raw.githubusercontent.com/vtexdocs/content-portal-content/refs/heads/main/images/en/verbs1.png"}}

{"base64":"  ","img":{"width":1452,"height":877,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":141596,"url":"https://raw.githubusercontent.com/vtexdocs/content-portal-content/refs/heads/main/images/en/verbs2.png"}}

User Interfaces

In buttons, use imperative verbs.

Do ✅Don't ❌
  • Create product
  • Visit store
  • New product
  • Store
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Abbreviations
« Previous
Pronouns
Next »
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
GithubCommunityFeedback