xref: /curl/docs/cmdline-opts/user-agent.md (revision dada880f)
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Short: A
5Long: user-agent
6Arg: <name>
7Help: Send User-Agent <name> to server
8Protocols: HTTP
9Category: important http
10Added: 4.5.1
11Multi: single
12See-also:
13  - header
14  - proxy-header
15Example:
16  - -A "Agent 007" $URL
17---
18
19# `--user-agent`
20
21Specify the User-Agent string to send to the HTTP server. To encode blanks in
22the string, surround the string with single quote marks. This header can also
23be set with the --header or the --proxy-header options.
24
25If you give an empty argument to --user-agent (""), it removes the header
26completely from the request. If you prefer a blank header, you can set it to a
27single space (" ").
28
29By default, curl uses curl/VERSION, such as User-Agent: curl/`%VERSION`.
30