Menu
Guides
Grammar
Formatting
Interface copy
Documentation
Glossary
Verbs
2 min read

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.To populate and test your store with features like product listing pages, search functionality, product detail pages, and checkout, create a catalog.
Open the VTEX Admin and access Storefront > FastStore WebOps.At the VTEX Admin, access Storefront > FastStore WebOps.
Enter your postal code.Entering your postal code.
Learn more about VTEX IO Clients and their advantages.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 productNew product
Visit storeStore
Contributors
0
Was this helpful?
Yes
No
Suggest edits (Github)
Contributors
0
On this page
GithubComunityFeedback