Formatting data consistently creates a clean, organized, and accessible experience.

For country names, follow https://countrycode.org/.

Do ✅	Don't ❌
US United States	USA United States of America

The standard US address has three lines: recipient; line one (street number and name), line two (unit or suite number), which is often optional; and line three (city, state, and postal code). Use the standard five-digit postal code. Don’t add the extra four digits unless automatically generated by an address confirmation system.

VTEX
11 E 44th St 11 Floor
New York, NY 10017

Write a comma between the city and state only. If an address has to be written in one line of text, put a comma after the street name and after the city.

11 E 44th St 11 Floor, New York, NY 10017

Follow the guidelines of the United States Postal Service for any special cases. For other countries, follow the guidelines of the main postal service of that country.

Do ✅	Don't ❌
931 Monroe Dr NE, Atlanta, GA 30308 670 Lafayette Ave, Brooklyn, NY 11216	Monroe Dr NE 931, Atlanta, GA 30308 670 Lafayette Ave, Brooklyn, New York, 11216 670 Lafayette Ave, Brooklyn, NY 11216-1031

When indicating an approximate location, you can use either the postal code in five-digit format, the city, or both. If both the city and the postal code are used, use a comma to separate them.

Do ✅	Don't ❌
11216 Brooklyn, 11216 Atlanta	11216-1031 Brooklyn, NY 11216 Monroe Dr

Use a two-letter lowercase language subtag and a two-letter uppercase country subtag separated by a hyphen to identify locales. This is based on the IETF BCP 47 standard, itself a combination of ISO standards.

Do ✅	Don't ❌
en-US en-GB	En-US EN

Use comma as the thousand separator and period as the decimal separator.

Do ✅	Don't ❌
1,230 9.5	1.230 9,5

When talking about empty values, such as null, 0, or empty.

Do ✅	Don't ❌
No products to show - Total budget spend - -	0 products to show - Total budget spend None 0%

When referring to installments, use only the number. Don’t use x as an abbreviation of the word installment.

Do ✅	Don't ❌
Pay in 3	Pay in 3x

Big numbers should use comma (,) as the thousand separator.

Do ✅	Don't ❌
37,809,009	37809009

Use large number abbreviations when space is a constraint.

Examples
60 thousand = 60K 60 million = 60M 60 billion = 60B 60 trillion = 60T

Use the following format of US phone numbers in local contexts (xxx) xxx-xxx and +1 (xxx) xxx-xxxx for international context.

Do ✅	Don't ❌
(843) 575-9211 +1 (511) 475-1731	843.575.9211 1-511-475-1731

For percentages, write the number and the symbol together, and either use no decimal places or use two.

Do ✅	Don't ❌
85% 85.31%	85 % 85.315 %

Use the country code when prioritizing clarity, and use the currency symbol in contexts that require more usability, such as a storefront.

Do ✅	Don't ❌
20,000 USD $20,000	$20KUSD $20,000USD USD$20,000

Do not add space between the symbol and value.

Do ✅	Don't ❌
$50 USD	$ 50 USD

Use a period as a decimal separator in currency values. Don't use separators for decimals, not even for long decimal numbers.

Do ✅	Don't ❌
$0.006653	$0,006653

The US date format is Month Day, Year of Day of the week, Month Day, Year. Use cardinal numbers for the day (1, 2, 30) and commas between the day of the week and the month and between the day and the year.

Do ✅	Don't ❌
January 1, 2020 April 15, 2025 Friday, December 21, 2029	January 1rst, 2020 April 15 25 Friday, 21/12/29

Use MM/DD/YYYY in forms and ranges.

Do ✅	Don't ❌
The feature was deprecated on May 13, 2020.	The feature was deprecated on May 13 2020.

Use 12-hour clock abbreviations in uppercase with no period.

Do ✅	Don't ❌
The promotions starts at 10:00 PM	The promotion starts at 10 p.m.

When an event or action actually happens based on a specific local time, include the city and UTC zone.

Do ✅	Don't ❌
10:30 AM São Paulo (GMT-3)	10:30 a.m São Paulo (GMT-3)

For time remaining, use 00d 00h 00m 00s. Include as many units of time as needed.

Do ✅	Don't ❌
2h 30m	150 minutes

For elapsed time, use x time word ago, such as created date and last modified.

Do ✅	Don't ❌
2 days ago	2d

Add a space between the number and the unit.

Do ✅	Don't ❌
1.9 lb 25 cm 7 kg	1.9lb 25cm 7kg

Put the plus or minus sign before the amount and the currency symbol with no space.

Do ✅	Don't ❌
+$45.00 USD -$6.99 USD	+ 45.00 USD - $6.99 USD

Never use plural in unit of measurement abbreviations.

Do ✅	Don't ❌
7 lb 60 ml 1 kg	7 lbs 60 mls 7 kgs

For pricing by measurement, never add a space before or after a slash.

Do ✅	Don't ❌
$50/m	$50 / m $20/ m

Always use numerals and units when writing quantities.

Do ✅	Don't ❌
5 in 15 m	five inches fifteen meters

Always use miles as the measure for distance.

Do ✅	Don't ❌
10 mi 0.55 mi	10 km 0.55 km

Always use en dash between ranges.

Do ✅	Don't ❌
1 – 30 search results 1kg – 4kg	1 - 30 search results 1kg - 4kg

When writing time, include the city and GMT zone.

Do ✅	Don't ❌
Maintenance is scheduled for Monday, April 14, 2025 at 10:30 a.m. São Paulo (GMT-3).	Maintenance is scheduled for Monday, April 14, 2025 at 10:30 a.m. São Paulo time.

If a number is under 10, spell it out (one, two, three, etc.). If it’s over (and including) 10, write it using digits (example: 43, 775), except when the number doesn’t refer to a specific value.

Do ✅	Don't ❌
This filter exceeds the maximum range of six months. If searches for an index frequently return more than a thousand documents...	This filter exceeds the maximum range of 6 months. If searches for an index frequently return more than a 1,000 documents…