↓ Skip to main content

Source: https://developers.google.com/style/ellipses ↗\n\n# Ellipses

  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- Avoid using ellipses (...) in technical documentation to indicate omission or hesitation.\n- When describing UI elements, omit ellipses unless their absence would create confusion.\n- In quoted text, ellipses can be used to replace omitted content mid-sentence, but not at the beginning or end.\n- Ellipses should be three periods with a space before and after, unless followed by punctuation.\n\nAvoid using ellipses (...) in technical documentation to indicate omission or hesitation.\n\nWhen describing UI elements, omit ellipses unless their absence would create confusion.\n\nIn quoted text, ellipses can be used to replace omitted content mid-sentence, but not at the beginning or end.\n\nEllipses should be three periods with a space before and after, unless followed by punctuation.\n\nIn general, don't use ellipses. An ellipsis is made up of

three contiguous periods. Ellipses indicate the omission of part of a sentence, paragraph, or larger block of text where the omission is not pertinent to the understanding of the subject at hand.\n\n\n## Ellipses as suspension points\n\nWhen ellipses are used to indicate hesitation, they are called suspension points. Don’t use ellipses this way in our documentation.\n\nNot recommended: The answer is … wait for it … that you shouldn’t do this.\n\n\n## Ellipses in a user interface\n\nWhen ellipses appear in a user interface, exclude them from the documentation describing the user interface unless their omission could cause confusion. For example, if the text on the button in the UI reads Save …, document it as click Save.\n\n\n## Ellipses in text\n\nDon’t use ellipses in your written documentation; omit any unnecessary information and include all necessary information.\n\nHowever, it’s acceptable to use ellipses in quoted text (to replace a portion of the quoted text) except when they appear at the beginning or end of the text.\n\nNot recommended: My high school English teacher made me learn that Shakespeare quote about all the world being a stage and " … all the men and women merely players."\n\nNot recommended: My high school English teacher made me learn that Shakespeare quote: “All the world’s a stage, And all the men and women merely players …."\n\nThe previous example ended with four ellipsis points. The final ellipsis point is, in fact, a period. So when the material that you’re omitting contains one or more sentence boundaries, use four dots instead of three.\n\nRecommended: My high school English teacher made me learn that Shakespeare quote: “All the world’s a stage, …. And one man in his time plays many parts."\n\n\n## Punctuation and spacing of ellipses\n\nKeep all three ellipsis points together. When creating an ellipsis, instead of the ellipsis character, use three periods in a row. Insert one space before and after the ellipsis unless a punctuation mark immediately follows the ellipsis; in this case, don’t insert a space after the ellipsis.\n\nRecommended: You don’t need to understand all the other Python code in there … we’ll explain it all in class.\n\nAlso recommended: You don’t need to understand all the other Python code in there …; we’ll explain it all in class.\n\nNot recommended: You don’t need to understand all the other Python code in there…we’ll explain it all in class.\n