Content style guide
Bulleted and numbered lists
Considerations
- Select the list type. Use numbered (also called “ordered”) lists when giving steps that someone must follow in a specific order. Use bulleted (also called “unordered”) lists for any list that doesn’t require a specific order.
- Introduce the list. Introduce the list with a full sentence. Avoid using “the following” in the list introduction and use a less formal phrase instead. For example, instead of “You’ll need the following documents,” use “You’ll need these documents.”
- Don’t combine the list items’ starting word or phrase with the introduction. For example, don’t introduce the list with “All of these must be true. You’re:” In this case, each item should start with “You’re.” This helps when the content needs to be translated into another language.
- Avoid single-item lists. Don’t use a numbered or bulleted list for only 1 item.
- Avoid using sub-bullets. Sub-bullets can make the content harder to scan. If possible, make the item with sub-bullets a separate list.
Note: Bulleted lists can be used in step-by-step lists. - Keep each item in a list succinct. Aim for no more than 1 or 2 sentences per list item to keep lists easy to scan.
- Connect items appropriately. When using “and” or “or” at the end of each list item, use a comma and bold the “and” or “or” at the end of each item.
Note: Don’t use “and/or” in lists. Instead, restructure the content to list all options (for example, “your income and/or net worth” should be “your income, your net worth, or both”). - Keep each list to no more than 7 items. If your list has more than 7 items, use subheads to break out the list into smaller, easier-to-digest lists.
- Use parallel construction within a list. Each list item should be consistent. For example, starting with a verb or noun phrase.
Punctuation
Here’s how we determine whether to include ending punctuation for lists:
- If all items in a list are single sentences or sentence fragments, don’t use ending periods for any list items (including the last item)
- If any list item contains 2 or more sentences, use ending periods for all items in the list (including any fragments)
Note: We determine punctuation by list, not by page. It’s OK to have a list of fragments with no ending periods on the same page as a list of multiple full sentences with ending periods. Just use the correct house style of punctuation for each type of list.
Example of bulleted list with fragments
Use parallel construction and don’t use ending periods for fragments.
Like this
What documents and information do I need to apply?
- Your Social Security number
- Your bank account direct deposit information
- Your education and military history
- Basic information about the school
Not this
What documents and information do I need to apply?
- Your Social Security number,
- Your bank account direct deposit information,
- Your education and military history,
- And basic information about the school.
Example of bulleted list with conjunctions
For complex eligibility criteria, we use the conjunctions “and” or “or” at the end of each individual requirement in the list to help make the relationship between the requirements clear. In these cases, use a comma before the conjunction and bold the “and” or “or” at the end of each bullet point. Always separate out lists of “and” and “or” requirements.
Like this
You may be eligible for VA disability benefits or compensation if you meet these requirements.
Both of these descriptions must be true:
- You have a current illness or injury (known as a condition) that affects your mind or body, and
- You served on active duty, active duty for training, or inactive duty training
And at least 1 of these descriptions must be true:
- You got sick or injured while serving in the military—and can link this condition to your illness or injury (called an in-service disability claim), or
- You had an illness or injury before you joined the military—and serving made it worse (called a pre-service disability claim), or
- You have a disability related to your active-duty service that didn’t appear until after you ended your service (called a post-service disability claim)
Not this
You may be eligible for VA disability benefits or compensation if you meet these requirements.
All of these descriptions must be true:
- You have a current illness or injury (known as a condition) that affects your mind or body,
- And you served on active duty, active duty for training, or inactive duty training,
- And you got sick or injured while serving in the military and can link this condition to your illness or injury (called an in-service disability claim),
- Or you had an illness or injury before you joined the military and serving made it worse (called a pre-service disability claim),
- Or you have a disability related to your active-duty service that didn’t appear until after you ended your service (called a post-service disability claim)
Example of non-eligibility-related bulleted list with “or” at the beginning of the list item
In some cases, you may need to add “or” to the beginning of the list item. For example, with list items that have 2 or more sentences, the conjunction may work better at the beginning of the second list item than at the end of the first.
Note: This guidance only applies to lists that use “or.”
Like this
If you want to provide more information about potential errors in our decision, you can use 1 of these 2 options:
- Request an informal conference with a VA reviewer. Our decision may take longer if you choose this option.
- Or submit a written statement. You must submit your statement with your completed VA Form 20-0996. You can send your documents by mail or submit them in person. We can’t accept written statements if you complete the online form.
Not this
If you want to provide more information about potential errors in our decision, you can use 1 of these 2 options:
- Request an informal conference with a VA reviewer. Our decision may take longer if you choose this option, or
- Submit a written statement. You must submit your statement with your completed VA Form 20-0996. You can send your documents by mail or submit them in person. We can’t accept written statements if you complete the online form.
Example of bulleted list with more than 1 sentence
If any item in a bulleted list contains 2 or more full sentences, use ending periods for all items in the list (including any fragments).
Like this
Here’s what you’ll need to apply:
- A Social Security number for you, your spouse, and your qualified dependents.
- Your military discharge information. If you sign in to apply, we may be able to fill in this information for you. If you don’t sign in to apply, we’ll ask you to upload a copy of your DD214 or other separation documents.
- Insurance cards for all health insurance companies that cover you. This includes any coverage that you get through a spouse or significant other. This also includes Medicare, private insurance, or insurance from your employer.
Not this
Here’s what you’ll need to apply:
- A Social Security number for you, your spouse, and your qualified dependents
- Your military discharge information. If you sign in to apply, we may be able to fill in this information for you. If you don’t sign in to apply, we’ll ask you to upload a copy of your DD214 or other separation documents.
- Insurance cards for all health insurance companies that cover you. This includes any coverage that you get through a spouse or significant other. This also includes Medicare, private insurance, or insurance from your employer.
Links in lists
- List items can be links in certain situations. But we don’t want to overwhelm people with a long list of links, if possible.
- Not all items in a list need to be a link. It’s OK to have only 1 or 2 items in a list linked.
- If every item in a list is a link, keep the list short (less than 7 items). Every link should go to a different location—don’t link to the same page multiple times in the list.
- If 1 link applies to all items in the list, add the link on a separate line after the list.
Like this
To continue your appeal, you have 60 days to take 1 of these actions:
- Submit VA Form 9 to the Board of Veterans’ Appeals, or
- Opt in to the decision review process
Here are some examples of situations a coordinator can help you with:
- You’re scheduled for a virtual hearing, but you never received a link to join the virtual hearing
- You’re scheduled for a video conference hearing or an in-person hearing at a VA facility and you want to switch to a virtual hearing
- Your virtual hearing is today, but you’re having trouble joining the hearing online
There are 3 options for adding links to list items. The formatting depends on what fits best with the content. The VA.gov content and IA team can help you pick the best option for your content.
Option 1
For lists with only a few items that have relevant links, add the links on a separate line after each list item. Use a soft return (shift + enter on PCs, shift + return on Macs) so the link appears on a separate line, aligned with the list indent, with no space between the lines.
Like this
Burial in a VA national cemetery includes these burial benefits:
- A gravesite in any of our national cemeteries with available space
Find a VA national cemetery - Opening and closing of the grave
- A burial liner provided by the government
- A headstone or marker provided by the government
Learn about eligibility for Veterans headstones and markers - Perpetual (ongoing) care of the gravesite
Not this
Burial in a VA national cemetery includes these burial benefits:
- A gravesite in any of our national cemeteries with available space
- Opening and closing of the grave
- A burial liner provided by the government
- A headstone or marker provided by the government
- Perpetual (ongoing) care of the gravesite
Option 2
When you have a list of brief items, make each of the list items a link. With this option, include the entire list item as part of the link. Don’t link just 1 or 2 words.
Like this
We offer many health and wellness programs, like these:
Not this
We offer many health and wellness programs, like these:
- Nutrition and food services
Learn more about nutrition and food services - Tobacco and health
Learn more about tobacco and health services - Weight management
Learn more about weight management services - Women’s health
Learn more about women’s health services - Mental health
Learn more about mental health services
Option 3
If options 1 and 2 don’t make sense for the content, add the link at the end of the item as a separate sentence.
Like this
You may be eligible for these VA benefits:
- VA health care. This includes regular checkups, appointments with specialists, and prescription refill and tracking. Find out if you’re eligible for VA health care benefits
- Travel pay reimbursement. The Beneficiary Travel program pays you back for mileage and other travel expenses to and from approved health care appointments. Find out if you’re eligible and how to request travel pay reimbursement
- VA dental care. If you qualify for VA dental care benefits, you may be able to get some or all of your dental care through VA. Find out about VA dental care
- VA vision care. If you qualify for VA health care benefits, you may be able to get some or all of your vision care through VA. Find out about VA vision care
- Veterans Affairs Life Insurance (VALife). VALife provides low-cost coverage to eligible Veterans with service-connected disabilities. Find out how to apply for VALife
Not this
You may be eligible for these VA benefits:
- VA health care. This includes regular checkups, appointments with specialists, and prescription refill and tracking.
- Travel pay reimbursement. The Beneficiary Travel program pays you back for mileage and other travel expenses to and from approved health care appointments.
- VA dental care. If you qualify for VA dental care benefits, you may be able to get some or all of your dental care through VA.
- VA vision care. If you qualify for VA health care benefits, you may be able to get some or all of your vision care through VA.
- Veterans Affairs Life Insurance (VALife). VALife provides low-cost coverage to eligible Veterans with service-connected disabilities.