> For the complete documentation index, see [llms.txt](https://docs.flatredball.com/gum/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flatredball.com/gum/code/files-and-fonts/supported-files.md).

# Supported Files

## Introduction

This page lists the file types Gum loads at runtime. The image and font tables have one column per runtime, and a ✓ means the runtime loads that format. The other sections apply to every runtime unless they say otherwise.

Gum resolves relative paths against `FileManager.RelativeDirectory`, which is covered on the [File Loading](https://docs.flatredball.com/gum/code/files-and-fonts/file-loading.md) page.

## Image Formats

Images load through a Sprite or NineSlice `SourceFile`, or by assigning a texture directly. Each runtime loads the formats its own image decoder supports.

|                                                  | MonoGame | FNA | KNI                      | raylib | SkiaGum |
| ------------------------------------------------ | -------- | --- | ------------------------ | ------ | ------- |
| `.png`                                           | ✓        | ✓   | Depends on platform head | ✓      | ✓       |
| `.jpg`, `.jpeg`                                  | ✓        | ✓   | Depends on platform head |        | ✓       |
| `.gif`                                           | ✓        | ✓   | Depends on platform head | ✓      | ✓       |
| `.bmp`                                           | ✓        |     | Depends on platform head | ✓      | ✓       |
| `.tif`                                           | ✓        |     | Depends on platform head |        |         |
| `.dds`                                           | ✓        |     | Depends on platform head | ✓      |         |
| `.tga`                                           |          | ✓   | Depends on platform head |        |         |
| `.qoi`                                           |          | ✓   | Depends on platform head | ✓      |         |
| `.webp`                                          |          |     | Depends on platform head |        | ✓       |
| Content pipeline assets (name without extension) | ✓        | ✓   | ✓                        |        |         |
| Loaded from a URL                                | ✓        | ✓   | ✓                        |        | ✓       |

KNI decodes images with the decoder of its platform head: System.Drawing on DesktopGL, WIC on WindowsDX, StbImageSharp on BlazorGL, and BitmapFactory on Android.

An animated `.gif` shows its first frame. SkiaGum hands the file to SkiaSharp without checking the extension, so it loads any format SkiaSharp decodes, including `.webp`. On raylib, Gum picks the decoder from the file extension, so keep the extension in line with the file's real format. An image that SkiaSharp or raylib cannot decode, such as a `.jpg` on raylib, fails like a missing file and follows `MissingFileBehavior`. Convert it to PNG or add an [image decoder](https://docs.flatredball.com/gum/code/files-and-fonts/file-loading/custom-image-formats.md).

`ContentLoader.SupportedImageExtensions` lists the image extensions your runtime loads, including the ones a registered image decoder declares.

{% hint style="info" %}
Available in November 2026, or now if building Gum from source.
{% endhint %}

MonoGame, KNI, and FNA load an image by name from the content pipeline when an `XnaContentManager` is assigned and the name has no extension.

## Fonts

|                                      | MonoGame | FNA | KNI | raylib | SkiaGum |
| ------------------------------------ | -------- | --- | --- | ------ | ------- |
| `.fnt` bitmap font with `.png` pages | ✓        | ✓   | ✓   | ✓      |         |
| `.ttf`                               | ✓        | ✓   | ✓   | ✓      | ✓       |
| `.otf`                               | ✓        | ✓   | ✓   | ✓      | ✓       |
| `.ttc`                               | ✓        | ✓   | ✓   | ✓      | ✓       |
| `.woff`                              | ✓        | ✓   | ✓   |        | ✓       |

Gum loads a bitmap font's `.png` pages from the folder of the `.fnt`. Setting a Text `Font` (or `CustomFontFile`) to a path ending in one of the font file extensions makes Gum load it as a font file. See [Fonts](https://docs.flatredball.com/gum/code/files-and-fonts/fonts.md) for choosing a strategy and [Font Strategies](https://docs.flatredball.com/gum/code/files-and-fonts/fonts/font-strategies.md) for the code.

## Gum Project Files

On every runtime, you can pass a project path to `GumService.Initialize`. Gum reads the elements listed in the project from the project folder.

| Kind              | XML     | JSON    |
| ----------------- | ------- | ------- |
| Project           | `.gumx` | `.gumj` |
| Screens           | `.gusx` | `.gusj` |
| Components        | `.gucx` | `.gucj` |
| Standard elements | `.gutx` | `.gutj` |
| Behaviors         | `.behx` | `.behj` |

A `.gumpkg` bundle, produced by [`gumcli pack`](https://docs.flatredball.com/gum/cli/cli/pack.md), loads in place of the loose project on every runtime. See [File Loading](https://docs.flatredball.com/gum/code/files-and-fonts/file-loading.md) for details.

## Animation Chains

On every runtime, a Sprite or NineSlice `SourceFile` accepts `.achx` and `.achj` animation chain files. See [Animation Chains](https://docs.flatredball.com/gum/code/files-and-fonts/animation-chains.md).

## Localization

On every runtime, Gum loads `.csv` and `.resx` localization files. A file linked in a Gum project loads when you initialize with that project. Code-only projects load a file with `AddCsvDatabase` or `AddResxDatabase`. See [Localization](https://docs.flatredball.com/gum/code/localization.md).

## Shader Files

A render target container loads a shader file through `SourceShaderFile`. See [ContainerRuntime](https://docs.flatredball.com/gum/code/standard-visuals/containerruntime.md#render-target-shaders-rendertargeteffect) for the code. Each ShadowDusk package is optional and registers with `UseShadowDusk()`.

|          | MonoGame                  | FNA                  | KNI                  | raylib                  | SkiaGum                    |
| -------- | ------------------------- | -------------------- | -------------------- | ----------------------- | -------------------------- |
| `.fx`    | `Gum.MonoGame.ShadowDusk` | `Gum.FNA.ShadowDusk` | `Gum.KNI.ShadowDusk` | `Gum.raylib.ShadowDusk` | `Gum.SkiaSharp.ShadowDusk` |
| `.slang` | `Gum.MonoGame.ShadowDusk` | `Gum.FNA.ShadowDusk` | `Gum.KNI.ShadowDusk` | `Gum.raylib.ShadowDusk` | `Gum.SkiaSharp.ShadowDusk` |
| `.sksl`  | `Gum.MonoGame.ShadowDusk` | `Gum.FNA.ShadowDusk` | `Gum.KNI.ShadowDusk` |                         | ✓                          |

SkiaGum is the only runtime that loads a shader file without a package, and only `.sksl`. On raylib, you can register your own shader resolver to load another format.

{% hint style="info" %}
Loading `.sksl` files through the MonoGame, FNA and KNI ShadowDusk packages is available in December 2026, or now if building Gum from source.
{% endhint %}

## SVG

SkiaGum loads `.svg` files into an Svg `SourceFile`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flatredball.com/gum/code/files-and-fonts/supported-files.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
