---
name: "fc-query"
section: "1"
platform: "linux"
package: "fontconfig"
version: "2:2.18.3-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/fc-query"
---

# fc-query(1)

query font files

## NAME

fc-query - query font files

## SYNOPSIS

**fc-query** \[ **-Vh** \]\
     \[ **-b** \| **--ignore-blanks** \] \[ **-i** *index* \| **--index** *index* \] \[ **-f** *format* \| **--format** *format* \] \[ **--version** \] \[ **--help** \] *font-file ...*

## DESCRIPTION

**fc-query** queries *font-file*(s) using the normal fontconfig rules and prints out font pattern for each face found. If **--index** is given, only one face of each file is queried, otherwise all faces are queried.

## OPTIONS

This program follows the usual GNU command line syntax, with long options starting with two dashes (\`-').  A summary of options is included below.

- **-b --ignore-blanks**

  Ignore blanks to compute languages

- **-i --index** *index*

  Only query face indexed *index* of each file.

- **-f --format** *format*

  Format output according to the format specifier *format*.

- **-V --version**

  Show version of the program and exit.

- **-h --help**

  Show summary of options.

- *font-file*

  Query *font-file* for font faces.

## RETURN CODES

**fc-query** returns error code 0 for successful parsing, or 1 if any errors occurred or if at least one font face could not be opened.

## SEE ALSO

[**fc-scan**(1)](/fc-scan/1.md) [**FcFreeTypeQuery**(3)](/FcFreeTypeQuery/3.md) [**FcPatternFormat**(3)](/FcPatternFormat/3.md) [**fc-cat**(1)](/fc-cat/1.md) [**fc-cache**(1)](/fc-cache/1.md) [**fc-list**(1)](/fc-list/1.md) [**fc-match**(1)](/fc-match/1.md) [**fc-pattern**(1)](/fc-pattern/1.md)

The fontconfig user's guide \<URL:https://fontconfig.pages.freedesktop.org/fontconfig/fontconfig-user.html\>

## AUTHOR

This manual page was updated by Behdad Esfahbod \<behdad@behdad.org\>.