To add line numbers to text means to prefix every logical line of your text with a sequential integer, separated from the original line by a character you choose, with optional leading-zero padding so the column stays aligned. Every input line receives exactly one number, including lines that are blank or contain only spaces. The numbers are written in ordinary base-ten digits, they increase by one for each line, and the line content itself is left untouched. The result is a single block of text where the original ordering is preserved, but every line now carries a stable numeric identifier you can point at in a review, a citation, or a class handout. A starting value of 1 produces the familiar 1, 2, 3 sequence; starting at 0 shifts the sequence to 0, 1, 2, and starting at a higher value shifts the whole sequence forward by that amount. Very long inputs can carry the sequence past six digits, because the six-digit bound applies to the starting number you type, not to the sequence as it grows. The separator is inserted exactly between each number and the original line, so the line content is never modified, and leading-zero padding, when enabled, widens every number so the column aligns without truncating any value.
If you have never used a line numbering tool before, the rest of this guide walks through what the tool does, the three settings you actually need to understand, and the exact steps to get a downloadable result. We will use the Add Line Numbers to Text tool throughout, because it runs entirely in the browser and produces a plain UTF-8 text file you can save anywhere.
What line numbering means in plain text
A line number is a small prefix attached to the start of each line in your text. It is not part of the original line content; it sits in front, separated by a character such as a period, a colon, a tab, or a vertical bar. The numbering is sequential: the first line gets one number, the next line gets the next number, and so on. If your input has nine lines, the output has nine numbers, regardless of how many of those lines were empty or contained only spaces.
This matters because beginners often assume blank lines are skipped. They are not. If you paste a three-line document where the middle line is empty, the output is three numbered lines, not two. That rule is intentional: it preserves the positional relationship between numbers and the original line sequence, so a reader who hears "look at line 7" can find that exact line in the source.
Why beginners reach for a line numbering tool
There are several everyday reasons to number the lines of a piece of text. Code review notes often say "fix the typo on line 42", which only works if every line is labeled. Transcripts of interviews and support calls get easier to quote when each line has a stable identifier. Teachers add numbers to handouts so students can refer back to a specific line during a class discussion. Lawyers and editors do the same when reviewing contracts and drafts. Poets and scriptwriters sometimes number their lines to keep track of stanzas and beats.
For beginners, the appeal is even simpler: you do not need to install software, learn a scripting language, or copy formulas into a word processor. A line numbering tool accepts pasted text, applies three settings, and returns a file you can save and reopen anywhere.
How to add line numbers to your text
- Paste or type the text you want numbered into the input area. Up to one million characters are accepted.
- Choose a starting number from 0 to 999999. You can begin at any whole non-negative integer in the allowed range.
- Set the separator. Common choices include a period and a space, a colon, a vertical bar, or a single tab. The separator is inserted exactly between each generated number and the original line text, and it is limited to 20 Unicode characters.
- Decide whether to turn on leading-zero padding. When padding is on, every generated number is widened with leading zeros so the column aligns.
- Click the action to generate the result. The tool splits CRLF, CR, and LF boundaries consistently, numbers every logical line including blanks, and joins the output with a single LF character.
- Inspect the preview to confirm the output matches what you expect. The preview uses preformatted wrapping so spaces and line breaks remain visible while long lines can wrap visually without changing the underlying text.
- Download the result as a UTF-8 plain-text file. The file has no byte-order mark, and you can rename or move it anywhere on your computer.
If you need to change a setting afterwards, editing any option clears the old result and revokes its download link, so the file you save is always the current output rather than a stale copy.
Settings first-time users actually need
The tool exposes three settings that change the output, plus one automatic behavior that keeps your download fresh. The table below describes each one in plain language, so you can decide which values to use before you click generate.
| Setting | What it controls | Beginner-friendly choice |
|---|---|---|
| Starting number | The integer assigned to the first logical line. Must be a whole non-negative integer with at most six digits. | 1 is the most common starting value. |
| Separator | Up to 20 Unicode characters inserted between the number and the original line. Spaces, punctuation, and tabs are all allowed; the characters are not interpreted as regular expressions. | A period followed by a single space, or a single tab. |
| Leading-zero padding | Widens every generated number so the column aligns. The width is set by the digit count of the final generated number. | Turn it on when the column needs to line up; turn it off when the natural width is fine. |
| Edit detection | Changing any option after generating clears the old result and revokes the download URL. | No action needed; the tool handles this automatically. |
How leading-zero padding behaves
When leading-zero padding is on, the tool picks the width from the last number in the sequence. If you start at 8 and you have three lines, the generated values are 08, 09, and 10, because the final number is two digits wide. If you start at 1 and you have nine lines, every generated number stays one digit wide, because the final number is 9 and is itself only one digit. Turning padding off renders each number at its natural width, so 8 stays 8 and 10 stays 10.
Padding only affects the generated numeric prefix. The original line text is never padded, trimmed, or modified. If you want to add a literal string to the beginning or end of each line instead, see Add Prefix and Suffix to Lines.
What happens to line endings
Line endings vary across operating systems: Windows uses a carriage return plus a line feed (CRLF), classic Mac used a lone carriage return (CR), and Unix uses a lone line feed (LF). The tool recognizes all three and treats them consistently: each boundary marks the end of one logical line and the start of the next. The preview and the downloaded file use a single LF character between output lines, so the file opens cleanly on every modern system without mixed byte markers.
A trailing newline at the end of your input creates a final empty logical line, and that line is also numbered. If your input ends with three blank lines, you get three extra numbered lines. This is the explicit rule that preserves the original line structure, so a reader can refer to "line 12" and find it in both the source and the output.
Things beginners should know before clicking generate
The tool refuses to run with a visible error message when the input is empty, the starting number is not a whole non-negative integer, or the separator is longer than 20 characters. None of those conditions produce a result, so you can adjust and try again.
The input limit is one million characters. This is not a soft cap; the tool will not accept longer inputs, because the work is bounded to keep the browser responsive and memory use predictable. For counting rather than transforming, the Line Counter tool gives you total, non-blank, and blank line counts without modifying the text.
Numbering happens locally in your browser. Nothing is uploaded, and the generated file is created from a local Blob in memory. According to the MDN documentation on Blob objects, this is how a browser exposes a snapshot of in-memory data as a downloadable file. The text-to-line splitting itself uses the standard String split method, which is the same primitive built into every modern browser.
When line numbering is the right tool for the job
Line numbering is the right choice when you need stable identifiers on every line of an existing block of text: code review references, transcripts, poetry or script drafts, support logs, legal-review working copies, classroom material, and any workflow where a reader might say "look at line N". It is not the right choice when you need to renumber an existing numbered list intelligently, when you want to count lines without changing them, or when you need page numbers instead of line numbers. The tool also does not preserve the original mixed CRLF and LF byte sequence; it normalizes every output to LF.
For each of these other tasks, a dedicated tool exists on this site. Counting only is handled by the Line Counter. Adding arbitrary text around each line, including the option to skip blank lines, is handled by the Add Prefix and Suffix to Lines tool. None of these alternatives overlap with line numbering, and each does exactly one thing, so the right tool is the one that matches the actual change you need to make.
Related reading: Add a Prefix to Each Line on Windows in Your Browser.