# Distribution metadata

> The export dialog in Nosmai Studio asks for the details that identify a filter: a display name, an ID, a description, a type, tags, a version, an author, and a minimum SDK version. These travel with the package so a developer or a catalogue can identify and version it. This page explains each field and its rules.

> For AI agents: the complete documentation index is at https://nosmai.com/llms/studio.txt

Product: Nosmai Studio
Group: studio-publishing
Source: https://nosmai.com/docs/studio/publishing/distribution-metadata/



## Overview

When you export, Nosmai Studio asks for the metadata that identifies the filter.
These details travel with the package so a developer, or a catalogue, can identify
and version it. Required fields must be filled before export is allowed.

**Product:** Nosmai Studio · **Platform:** macOS, Windows · **Updated:**
6 October 2026 · **Reading time:** 5 minutes

## The fields

![The export dialog, where the distribution details are entered below the file options.](/images/studio/export-dialog.png)

| Field | Required | Rules |
| --- | --- | --- |
| Display name | Yes | The filter's shown name |
| ID | Yes | A slug, derived from the name. Names the output folder and files |
| Description | No | A short description |
| Filter type | Yes | What kind of filter this is |
| Tags | No | Keywords for a catalogue |
| Version | Yes | Semantic version (for example `1.0.0`) |
| Author | Yes | Who made it |
| Minimum SDK version | Yes | The lowest Nosmai SDK version that can run it. Default `3.0.0` |
| Created | Yes | A valid date |

Defaults are pulled from the filter's manifest and any stored distribution details,
so re-exporting the same filter keeps its identity.

## Validation

Export checks the metadata before it runs:

- Display name, ID, author, and filter type must be present.
- Version and minimum SDK version must be valid semantic versions.
- Created must be a valid date.

If any check fails, the Export button stays disabled and names the field to fix.

## Verify it worked

- The output files are named after the ID.
- The exported manifest carries the name, version, author, and minimum SDK version.
- Re-exporting keeps the same ID and increments nothing automatically (you set the
  version).

## Common problems

| What you see | Why | Fix |
| --- | --- | --- |
| Export is disabled | A required field is empty | Fill display name, ID, author, filter type, version, minimum SDK, and created |
| Export rejects the version | It is not a valid semantic version | Use a form like `1.0.0` |
| The ID is not what you typed | The ID is a slug of the name | Edit the ID field directly if you need a specific slug |
| A device will not load the filter | Its minimum SDK version is higher than the device's SDK | Lower the minimum SDK version, or update the app's SDK |

## Next steps

- [Export a package](/docs/studio/publishing/export-a-package/)
- [What happens after export](/docs/studio/publishing/after-export/)
- [Check performance](/docs/studio/guides/check-performance/)

## Reference

- [File formats](/docs/studio/reference/file-formats/)
- [Layer kinds](/docs/studio/reference/layer-kinds/)
