.TH SQ 1 0.38.0 "Sequoia PGP" "User Commands"
.SH NAME
sq key userid add \- Add a user ID
.SH SYNOPSIS
.br
\fBsq key userid add\fR [\fIOPTIONS\fR]  
.SH DESCRIPTION
Add a user ID.
.PP
A user ID can contain a name, like `Juliet`, or an email address, like `<juliet@example.org>`.  Historically, a name and an email address were usually combined as a single user ID, like `Juliet <juliet@example.org>`.
However, user IDs that include different information such as name and
email address are more difficult to reason about, so using distinct
user IDs for name and email address is preferred nowadays.
.PP
`sq userid add` respects the reference time set by the top\-level `\-\-time` argument.  It sets the creation time of the user ID's binding signature to the specified time.
.PP


.SH OPTIONS
.SS "Subcommand options"
.TP
\fB\-\-allow\-non\-canonical\-userids\fR
Don't reject user IDs that are not in canonical form.
.IP
Canonical user IDs are of the form `Name (Comment) <localpart@example.org>`.
.TP
\fB\-\-binary\fR
Emit binary data
.TP
\fB\-\-cert\fR=\fIFINGERPRINT|KEYID\fR
Add the user ID to the specified certificate
.TP
\fB\-\-cert\-file\fR=\fICERT_FILE\fR
Add the user ID to the specified certificate
.TP
\fB\-\-email\fR=\fIADDRESS\fR
Add an email address as user ID to the key
.TP
\fB\-\-name\fR=\fINAME\fR
Add a name as user ID to the key
.TP
\fB\-\-output\fR=\fIFILE\fR
Write to the specified FILE.
.IP
If not specified, and the certificate was read from the certificate store, imports the modified certificate into the cert store.  If not specified, and the certificate was read from a file, writes the modified certificate to stdout.
.TP
\fB\-\-userid\fR=\fIUSERID\fR

Add a user ID to the key.
.IP
This user ID can combine name and email address, can optionally
contain a comment, or even be free\-form if
`\-\-allow\-non\-canonical\-userids` is given.  However, user IDs that
include different information such as name and email address are more
difficult to reason about, so using distinct user IDs for name and
email address is preferred nowadays.
.IP
In doubt, prefer `\-\-name` and `\-\-email`.

.SS "Global options"
See \fBsq\fR(1) for a description of the global options.
.SH EXAMPLES
.PP

.PP
Add a new user ID to Alice's key.
.PP
.nf
.RS
sq key userid add \-\-cert \\
.RE
.RS
.RS
EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \-\-name Alice \\
.RE
.RE
.RS
.RS
\-\-email alice@work.example.com
.RE
.RE
.fi
.SH "SEE ALSO"
.nh
\fBsq\fR(1), \fBsq\-key\fR(1), \fBsq\-key\-userid\fR(1).
.hy
.PP
For the full documentation see <https://book.sequoia\-pgp.org>.
.SH VERSION
0.38.0 (sequoia\-openpgp 1.21.2)