Source: https://developers.google.com/style/lists\n\n# Lists



      Stay organized with collections



      Save and categorize content based on your preferences.\n\n- Home\n- Products\n- Style\n\n\n## Page Summary\n\n- Tables are ideal for presenting structured data with multiple properties, while lists are better for sequential information or a simple collection of items.\n- Choose from numbered, bulleted, or description lists depending on the content's purpose, using proper capitalization and punctuation for clarity.\n- Introduce lists with a complete sentence for context and maintain parallel structure (syntax/grammar) across all list items.\n- When crafting descriptions, format run-in headings consistently and punctuate accordingly to ensure readability and clarity.\n- For sub-steps in procedures and unusual numbering, refer to specific sections within the documentation for guidance.\n\nTables are ideal for presenting structured data with multiple properties, while lists are better for sequential information or a simple collection of items.\n\nChoose from numbered, bulleted, or description lists depending on the content's purpose, using proper capitalization and punctuation for clarity.\n\nIntroduce lists with a complete sentence for context and maintain parallel structure (syntax/grammar) across all list items.\n\nWhen crafting descriptions, format run-in headings consistently and punctuate accordingly to ensure readability and clarity.\n\nFor sub-steps in procedures and unusual numbering, refer to specific sections within the documentation for guidance.\n\n\n## List or table?\n\nTables and lists are both ways to present a set of similarly structured
items. Sometimes it's not obvious when to choose one presentation over the
other. To decide which presentation to use, see
  List or table?\n\nNote: Don't use a list to show only one item; a single
item isn't really a list. If you want to set a single item off from surrounding
text, then use some other formatting.\n\n\n## Types of lists\n\nChoose one of the following list styles. The following table includes common ways to present
  lists in our documentation:\n\n\nList type | Used for | HTML elements\nNumbered list | A set of items where the sequence is significant, such as ordered steps, phases, or
      priorities. The following is an example of a numbered list:

Here's a sequence of steps to follow:

Open the box.
Remove the bobcat from the box.
Feed the bobcat.

Nested sequential lists are labeled with lowercase letters or lowercase Roman
        numerals. The following is an example of a nested sequential list:
Here's a list of things to do after breakfast, in order:

Go shopping.

Buy groceries:

Flour
Eggs
Sugar
Butter


Go to mall:

Buy dress.
Buy shoes.




Make cake.
Build birthday present out of spare parts.
Clean house.

See also Sub-steps in numbered procedures. | ol, li\nBulleted list | A set of items that's not a sequence, such as a set of nonsequential options or examples.
      Make sure it's clear whether or not every item is required. The following is an example of a
      bulleted list:
Here's a list of things that can go wrong, in no particular order:

Your bicycle might explode.
The sun might go out.
An ant might break its leg and require a tiny splint. | ul, li\nDescription list | A set of terms, each with a description, definition, or explanation. Use this type of list
      if you want to draw attention to two or more terms (such as a glossary). The following is an
      example of a description list:
Here are some descriptions of types of birds:

Emu
The best kind of bird.
Crow
The other best kind of bird.
Peacock
Also the best kind of bird.
Phoenix
An even better kind of bird. | dl, dt, dd\nDescription list that uses bulleted run-in headings | A set of introductory terms or phrases, each followed by a description, definition, or
      explanation. Use this type of list if you want to highlight and explain several concepts or
      save space. For information about how to format and punctuate run-in headings and their
      descriptions, see
      Description lists that use run-in
        headings in this document.
The following is an example of a description list that uses bulleted run-in headings:
Here are some descriptions of types of birds:

Emu: the best kind of bird
Crow: the other best kind of bird
Peacock: also the best kind of bird
Phoenix: an even better kind of bird | ul, li\n\nA set of items where the sequence is significant, such as ordered steps, phases, or
      priorities. The following is an example of a numbered list:\n\n> Here's a sequence of steps to follow:

Open the box.
Remove the bobcat from the box.
Feed the bobcat.\n\nHere's a sequence of steps to follow:\n\n- Open the box.\n- Remove the bobcat from the box.\n- Feed the bobcat.\n\nNested sequential lists are labeled with lowercase letters or lowercase Roman
        numerals. The following is an example of a nested sequential list:\n\n> Here's a list of things to do after breakfast, in order:

Go shopping.

Buy groceries:

Flour
Eggs
Sugar
Butter


Go to mall:

Buy dress.
Buy shoes.




Make cake.
Build birthday present out of spare parts.
Clean house.\n\nHere's a list of things to do after breakfast, in order:\n\n- Go shopping.

Buy groceries:

Flour
Eggs
Sugar
Butter


Go to mall:

Buy dress.
Buy shoes.\n- Buy groceries:

Flour
Eggs
Sugar
Butter\n- Flour\n- Eggs\n- Sugar\n- Butter\n- Go to mall:

Buy dress.
Buy shoes.\n- Buy dress.\n- Buy shoes.\n- Make cake.\n- Build birthday present out of spare parts.\n- Clean house.\n\n- Buy groceries:

Flour
Eggs
Sugar
Butter\n- Flour\n- Eggs\n- Sugar\n- Butter\n- Go to mall:

Buy dress.
Buy shoes.\n- Buy dress.\n- Buy shoes.\n\n- Flour\n- Eggs\n- Sugar\n- Butter\n\n- Buy dress.\n- Buy shoes.\n\nSee also Sub-steps in numbered procedures.\n\nA set of items that's not a sequence, such as a set of nonsequential options or examples.
      Make sure it's clear whether or not every item is required. The following is an example of a
      bulleted list:\n\n> Here's a list of things that can go wrong, in no particular order:

Your bicycle might explode.
The sun might go out.
An ant might break its leg and require a tiny splint.\n\nHere's a list of things that can go wrong, in no particular order:\n\n- Your bicycle might explode.\n- The sun might go out.\n- An ant might break its leg and require a tiny splint.\n\nA set of terms, each with a description, definition, or explanation. Use this type of list
      if you want to draw attention to two or more terms (such as a glossary). The following is an
      example of a description list:\n\n> Here are some descriptions of types of birds:

Emu
The best kind of bird.
Crow
The other best kind of bird.
Peacock
Also the best kind of bird.
Phoenix
An even better kind of bird.\n\nHere are some descriptions of types of birds:\n\nA set of introductory terms or phrases, each followed by a description, definition, or
      explanation. Use this type of list if you want to highlight and explain several concepts or
      save space. For information about how to format and punctuate run-in headings and their
      descriptions, see
      Description lists that use run-in
        headings in this document.\n\nThe following is an example of a description list that uses bulleted run-in headings:\n\n> Here are some descriptions of types of birds:

Emu: the best kind of bird
Crow: the other best kind of bird
Peacock: also the best kind of bird
Phoenix: an even better kind of bird\n\nHere are some descriptions of types of birds:\n\n- Emu: the best kind of bird\n- Crow: the other best kind of bird\n- Peacock: also the best kind of bird\n- Phoenix: an even better kind of bird\n\n\n## Multiple paragraph list items\n\nAny list item can contain more than one paragraph.\n\nTo create multiple paragraphs, use the p element rather
than using the br element. (The HTML specification describes which uses of the
br
element are legitimate and which aren't.)\n\nExample of a list item that contains more than one paragraph:\n\n- This list item is a single paragraph.\n- This list item contains multiple paragraphs.
As you can see!\n- This is another list item that's only one paragraph long.\n\nThis list item contains multiple paragraphs.\n\nAs you can see!\n\n\n## Introductory sentences for lists\n\nIntroduce a list with the appropriate context. In most cases, precede a list
with an introductory sentence. The sentence can end with a colon or a period; usually a colon if it
immediately precedes the list, usually a period if there's more material (such as a note
paragraph) between the introduction and the list.\n\nIf the list doesn't need any additional context other than the heading that immediately precedes
  the list, it's OK to not introduce a list with an introductory sentence.\n\nIntroduce a list with a complete sentence, not a partial one that's
completed by the list items. You can also use the following as a noun phrase (see
following in the word list).\n\n\nRecommended | Not recommended\nUse the Submit button for any of the following purposes:

To submit the form.
To indicate that you're done.
To allow the next person to enter their data. | Use the Submit button to:

Submit the form.
Indicate that you're done.
Allow the next person to enter their data.\nTo get the USB driver, follow these steps:

Click Tools >
          Android > SDK Manager.
Select Google USB Driver, and then click OK. | To get the USB driver:

Click
          Tools > Android >
          SDK Manager.
Select Google USB Driver, and then click OK.\nIf you need to add an instance manually, do the following:

Click Create instance.
For Name, enter a name. | If you need to add an instance manually:

Click Create instance.
For Name, enter a name.\nObjectives

Create an instance
Snapshot an instance
Delete an instance | Objectives

          In the following tutorial, you will complete the following tasks:


Create an instance
Snapshot an instance
Delete an instance\n\nUse the Submit button for any of the following purposes:\n\n- To submit the form.\n- To indicate that you're done.\n- To allow the next person to enter their data.\n\nUse the Submit button to:\n\n- Submit the form.\n- Indicate that you're done.\n- Allow the next person to enter their data.\n\nTo get the USB driver, follow these steps:\n\n- Click Tools >
          Android > SDK Manager.\n- Select Google USB Driver, and then click OK.\n\nTo get the USB driver:\n\n- Click
          Tools > Android >
          SDK Manager.\n- Select Google USB Driver, and then click OK.\n\nIf you need to add an instance manually, do the following:\n\n- Click Create instance.\n- For Name, enter a name.\n\nIf you need to add an instance manually:\n\n- Click Create instance.\n- For Name, enter a name.\n\n\n#### Objectives\n\n- Create an instance\n- Snapshot an instance\n- Delete an instance\n\n\n#### Objectives\n\nIn the following tutorial, you will complete the following tasks:\n\n- Create an instance\n- Snapshot an instance\n- Delete an instance\n\nFor information about introducing sub-steps, see Sub-steps in numbered procedures.\n\nFor information about punctuation and capitalization of lists, see
Capitalization and end punctuation.\n\n\n## Unusual list numbering\n\nUse nonstandard numbering in the following situations:\n\n- To present a list in reverse-numerical order, use an
    ol element with a reversed attribute.\n- To set a value manually, use the value attribute. In some cases, setting a
    value manually can be convenient. However, in most cases, it isn't a good idea to manually
    number a list item in a numbered list, because if the number of items changes later, you'll
    have to manually change the value.\n\n\n## Sub-steps in a numbered procedure\n\nFor information about sub-steps in a numbered procedure, see
  Procedures.\n\n\n## Parallel syntax\n\nUse the same syntax/structure for all list items in a given list, if
possible.\n\n\n## Capitalization and end punctuation\n\nCapitalization and end punctuation depend on the type of list and the
contents of the list.\n\n\n### Numbered, lettered, and bulleted lists\n\nStart each list item with a capital letter, unless case is an important part of
the information conveyed by the list—such as in a list of glossary terms.\n\nEnd each list item with a period or other appropriate sentence-ending
punctuation, except in the following cases:\n\n- If the item consists of a single word, don't add end punctuation.\n- If the item doesn't include a verb, don't add end punctuation.\n- If the item is entirely in code font, don't add end punctuation.\n- If the item is entirely link text or a document title, don't add end punctuation.\n\nIf you end up with inconsistent punctuation in your list, then either rewrite your list to use
  parallel construction or add end punctuation to every list item
  for consistency.\n\nRecommended:\n\nThe following words are adjectives:\n\n- Big\n- Small\n- Gratuitous\n\nRecommended:\n\nThe SDK supports the following UI elements:\n\n- Text box\n- Bulleted list\n- Button\n\nRecommended:\n\nThe API supports the following actions:\n\n- Create\n- Replace\n- Update\n- Delete\n\nRecommended:\n\nYou can do any of the following by using the API:\n\n- Create an item.\n- Replace one item with another.\n- Update an item.\n- Delete an item.\n\n\n### Description lists\n\nSometimes it's useful to add an explanatory phrase to a list item, which can
affect the punctuation. In general, don't add an explanatory phrase to only a
single list item; instead, use a description list, and provide explanatory
phrases for all items.\n\nIn most contexts, start each term (dt element) with a capital letter.\n\nDon't end the term with a period. Do generally put a period at the end of
each dd ("description") element.\n\n\nRecommended | Not recommended\nThe following words are adjectives:

Big
A short word.
Relevant
A fancy word.
Gratuitous
A long word.
Purple
A vibrant color. | The following words are adjectives:

Big
Relevant
Gratuitous
Purple—this is a color.\n\nThe following words are adjectives:\n\nThe following words are adjectives:\n\n- Big\n- Relevant\n- Gratuitous\n- Purple—this is a color.\n\n\n### Description lists that use run-in headings\n\nIn most contexts, format run-in headings as follows:\n\n- Start the run-in heading with a capital letter.\n- End the run-in heading with a period or a colon, but be consistent within the list.\n- You can decide whether to bold the punctuation that ends the heading based on factors
       such as on-page consistency.\n\nFor the descriptions that follow the punctuation, capitalize the first letter as follows:\n\n- If the text follows a period, start the text with a capital letter.\n- If the text follows a colon, start the text with a lowercase letter.\n\nTo end the descriptive text, punctuate as follows:\n\n- If the description follows a period, end the description with a period.\n- If the description follows a colon, do one of the following:\n- If the description is a list of items or short phrases without verbs, don't include a
            period.\n- If the description includes a verb or expresses a standalone thought, end the
            description with a period.\n\n- If the description is a list of items or short phrases without verbs, don't include a
            period.\n- If the description includes a verb or expresses a standalone thought, end the
            description with a period.\n\nDon't use a dash to set off a description from an item in a description list. For more
  information, see
  Colons instead of dashes in
  lists.\n\nRecommended:\n\nThe following words are adjectives:\n\n- Big: a short word\n- Relevant: a fancy word\n- Gratuitous: a long word\n- Purple: a vibrant color\n\nRecommended:\n\nThe coffee shop has several great choices:\n\n- Coffee: latte, mocha,  cappuccino, espresso, macchiato\n- Tea: chai tea, chai latte, black tea, green tea, herbal tea\n\nRecommended:\n\nBudget Airlines reduces your ticket cost in several ways:\n\n- It increases fuel economy by reducing baggage weight. By charging
          astronomical prices for anything larger than a wallet....\n- It carries more passengers per flight. By reducing leg room to industry and
          medical minimums, it fits more seats....\n\n\n## Comma-separated lists\n\nWhen you write a list in a paragraph, use
serial commas to separate the items.\n\nAvoid ending a list with etc. or phrases like and so on.
Instead, introduce the list in a way that makes it clear that the list isn't
all-inclusive.\n\nRecommended: The service processes data
like event logs, clickstream data, social network interactions, and e-commerce
transactions.\n\nNot recommended: The service processes
event logs, clickstream data, social network interactions, e-commerce
transactions, etc.\n\nFor more information, see etc.\n