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 category | Create 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.


User Interfaces
In buttons, use imperative verbs.
Do ✅ | Don't ❌ |
---|---|
Create product | New product |
Visit store | Store |