Stay organized with collections
Save and categorize content based on your preferences.
This page describes how to use and format phone numbers in technical documentation. This page
doesn't provide guidance on how to enter or use phone numbers in Google or third-party products.
If you need information about entering phone numbers in a specific product, consult the
product documentation or contact product support.
Use example phone numbers
Most phone numbers in our documentation are examples. To show an example phone number, use a US
number in the range 800‑555‑0100 through 800‑555‑0199. That range is
reserved for use in examples and in fiction.
Recommended: 800‑555‑0175
Never use a real phone number in examples.
Format phone numbers in HTML or Markdown
To ensure that a phone number is displayed on the same line, use a nonbreaking hyphen
(‑) where appropriate in HTML or Markdown.
Example
415‑555‑0132
HTML
415‑555‑0132
Markdown
415‑555‑0132
Format North American phone numbers
To format a real phone number in the US, Canada, and other NANP
(North American Numbering Plan) countries, use a nonbreaking hyphen to separate the area code,
three-digit exchange code, and four-digit number.
Recommended: 415‑555‑0132
Format international phone numbers
To format a real phone number in non-NANP countries, include the country and area
codes. Insert a plus sign
immediately before the country code (no space); the plus sign stands in for a
prefix known as an exit code, which lets you dial out of a country. Each
country has a different exit code.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-12-20 UTC."],[[["This guide provides formatting instructions for phone numbers in technical documentation, using HTML or Markdown."],["Use non-breaking spaces and hyphens (` `, `‑`) to ensure phone numbers are displayed on a single line."],["For example phone numbers, utilize the reserved range (800) 555‑0100 through (800) 555‑0199 and avoid real numbers."],["Adhere to specific formatting guidelines for North American and international phone numbers, including country and area codes when applicable."],["When including extensions, follow the phone number with the word \"extension\" and the corresponding number."]]],["Technical documentation should use example US phone numbers within the 800-555-0100 to 800-555-0199 range, avoiding real numbers. Format numbers using nonbreaking hyphens (‑) in HTML/Markdown. For North American numbers, separate area code, exchange code, and number with nonbreaking hyphens. For international numbers, prefix the country code with a plus sign (+). Include extensions after the number, preceded by the word \"extension.\"\n"]]
