---
name: "odfuserfield"
section: "1"
platform: "linux"
package: "python-odfpy"
version: "1.4.2-7"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/odfuserfield"
---

# odfuserfield(1)

." make the size of the head bigger **NAME** **odfuserfield - List or change the user-field declarations in an ODF file**

**." make the size of the head bigger** **SYNOPSIS**

**odfuserfield** \[-l\] \[-L\] \[-x *field*...\] \[-X *field*...\] \[-s *field:value*...\] \[-o *path*\] *path*

." make the size of the head bigger **DESCRIPTION**

**Odfuserfield** is a program that will list or change the user variable declarations in an OpenDocument file. There are two kinds of variables in OpenDocument. Simple variables can take different values at different positions, throughout a document. User variables have the same value throughout a document. Due to the latter´s global nature it is safe to change them with an external application.

Use **odfuserfield** to fill out form letters before printing or giving to the user.

“Path” is assumed to be an OpenDocument file of text, spreadsheet or presentation type.

." make the size of the head bigger **OPTIONS**

**-l**

**List (extract) all known user-fields.**

**-L**

**List (extract) all known user-fields with type and value.**

**-x** *field*

Extract the contents of this field from the file.

\-X *field*

Same as -x, but also preserves/includes the field name and type.

\-s *field:value*

Set the value of an existing user field. The field type will be the same.

\-o *path*

Filename to write modified ODT file to. If no **-o** option is provided, the ODT file will be written to stdout.

." make the size of the head bigger **EXAMPLE**

```

odfuserfield -L odf-file
```

**." make the size of the head bigger** **SEE ALSO**

[**formail**(1)](/formail/1.md), [**id3tag**(1)](/id3tag/1.md)

." make the size of the head bigger **TODO**

**Implement formulas. See OpenDocument v1.0 specification section 6.3.5. This requires a different syntax for -s arguments.**

**." make the size of the head bigger** **AUTHORS**

**Søren Roug**

Original author

**Michael Howitz**\
 gocept gmbh & co. kg

Refactoring