← All commands
THE COMMAND REFERENCE

paste

Join lines from several files side by side, or join one file's lines into one.

Last updated

BusyBox

Implementation-level reference; examples are not certified for every installed version.

Overview

paste glues files together line by line: line 1 of each file goes on one output line, separated by a tab, then line 2, and so on. It is the opposite of cut, which pulls columns apart. With -s it turns the lines of one file into a single line, and a - reads standard input.

Background

A paste command appeared in Version 7 AT&T UNIX/32V, according to the macOS manual. Today the name covers GNU paste, the paste that macOS ships, and the paste applet in BusyBox. They agree on the tab default, -d and -s.

Examples

Put two files side by side, separated by a tab:

printf 'a\nb\n' > names.txt && printf '1\n2\n' > nums2.txt && paste names.txt nums2.txt

Use a comma as the separator with -d:

printf 'a\nb\n' > names.txt && printf '1\n2\n' > nums2.txt && paste -d, names.txt nums2.txt

Join all the lines of a file into one with -s:

printf 'a\nb\nc\n' > names.txt && paste -s names.txt

Join them with commas instead of tabs:

printf 'a\nb\nc\n' > names.txt && paste -sd, names.txt

Arrange a stream into columns; each - takes the next line of standard input, so three of them make three columns:

seq 6 | paste - - -

Join numbers into an expression for a calculator, with a plus sign as the separator:

seq 3 | paste -sd+ -

Options

-d
Use these characters, one after the other, instead of a tab between the joined lines.

-s
Paste one file at a time: all its lines are joined into one output line.

Common mistakes

paste does not match lines by content; it just pairs the nth line of each file, so files of different lengths leave empty columns. To join by a shared key, use join. The default separator is a tab, which looks like spaces on a screen but is a different character when you search or sort the output.

Portability

Only -d, -s and - for standard input are in the Common examples. Behavior with a multi-character -d list is the same idea on every system, but check it on yours before relying on it. The Common examples were executed on GNU coreutils 9.11, macOS system tools, and BusyBox 1.37.0 (see the development guide for the exact check).

About BusyBox paste

BusyBox bundles paste as an applet, and anything beyond the common options depends on how it was built. This page's examples ran on BusyBox 1.37.0.

BusyBox notes

BusyBox paste supports -d and -s. GNU long options depend on the build.

References

Original explanations, with upstream documentation for further reading. FreeBSD references are comparison material, not a claim of Apple version equivalence.