---
title: "Catalog import: organize your files"
description: File naming and folder structure guidelines for Filmhub catalog imports, plus free tools to check your files.
---

[Skip to content](https://help.filmhub.com/catalog-import-file-organization#main-content)

English

Show submenu for translations

![Filmhub\_Logotype\_Neg.png\]](https://help.filmhub.com/hs-fs/hubfs/Filmhub_Logotype_Neg.png?height=25&name=Filmhub_Logotype_Neg.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- Login/Get Started

 Login/Get Started

 How can we help?

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.filmhub.com/?hsLang=en)
2. [Submit Your Title](https://help.filmhub.com/submit-your-title?hsLang=en)
3. [Large Catalog Import](https://help.filmhub.com/submit-your-title?hsLang=en#large-catalog-import)

# Catalog import: organize your files

## How to name and organize your catalog files so we can match them to your titles quickly.

### In this guide:

- [Why file organization matters](https://help.filmhub.com/catalog-import-file-organization#why-file-organization-matters)
- [Use one folder per title](https://help.filmhub.com/catalog-import-file-organization#use-one-folder-per-title)
- [Use your metadata IDs in file names](https://help.filmhub.com/catalog-import-file-organization#use-your-metadata-ids-in-file-names)
- [Use standard characters only](https://help.filmhub.com/catalog-import-file-organization#use-standard-characters-only)
- [Describe each file in its name](https://help.filmhub.com/catalog-import-file-organization#describe-each-file-in-its-name)
- [Tools to check your files](https://help.filmhub.com/catalog-import-file-organization#tools-to-check-your-files)

---

### Why file organization matters

We accept files in any structure. A consistent structure lets us match each file to the right title automatically, which speeds up your import and reduces mapping errors.

### Use one folder per title

Give each title its own folder at the root of your delivery, with all of that title's assets inside it. Don't leave any assets outside these folders.

### Use your metadata IDs in file names

Where possible, include the internal IDs from your [metadata template](https://help.filmhub.com/hubfs/Filmhub%20-%20Catalog%20Import%20Metadata%20Template%20(Jan%202026).xlsx?hsLang=en) in your file names. Matching IDs let us connect each file to its metadata without manual review.

### Use standard characters only

Use letters, numbers, hyphens (-), and underscores (\_). Avoid accented characters, spaces, and other punctuation, which some transfer and storage systems can't read.

### Describe each file in its name

Along with the ID and title name, add a short descriptor for what each file is.

- **Video:** label as "main", "trailer", and so on. Language, frame size, and codec are also useful to include.
- **Captions:** include a language code and the text type, such as "forced", "closed captions", or "subtitles".
- **Artwork:** include the aspect ratio. See [Artwork requirements](https://help.filmhub.com/en/articles/2663773-artwork-requirements?hsLang=en) for required sizes.

![Sample file structure](https://help.filmhub.com/hs-fs/hubfs/Imported%20images/File+Structure.png?width=273&height=239&name=File+Structure.png)

### Tools to check your files

These free tools help you confirm your files meet our requirements before you transfer them:

- [MediaInfo](https://mediaarea.net/en/MediaInfo) shows technical details for most file formats, such as bitrate, frame rate, and codec. Use it to check video files against our [video and audio requirements](https://help.filmhub.com/en/articles/2663770-video-audio-requirements?hsLang=en).
- [WinMerge](https://winmerge.org/) (Windows) compares caption files and other text files. On Mac, FileMerge does the same and comes with Xcode from the App Store.

### Related articles

- [How Large Catalog Import works](https://help.filmhub.com/large-catalog-import?hsLang=en)
- [Catalog import requirements](https://help.filmhub.com/catalog-import-specs?hsLang=en)
- [Catalog import: asset transfer process](https://help.filmhub.com/en/articles/8014009-catalog-import-asset-transfer-process?hsLang=en)
- [Catalog import: best practices](https://help.filmhub.com/catalog-import-best-practices?hsLang=en)

### Need more help?

Search the [Help Center](https://help.filmhub.com/?hsLang=en) or [submit a support request](https://help.filmhub.com/contact-support?hsLang=en). Email and chat with our team are included with Premium and Premium Plus. [Compare plans](https://help.filmhub.com/plans?hsLang=en)

- [Getting Started](https://help.filmhub.com/getting-started?hsLang=en#main-content)

    - [How Filmhub Works](https://help.filmhub.com/getting-started?hsLang=en#how-filmhub-works)
    - [Your Account and Plan](https://help.filmhub.com/getting-started?hsLang=en#your-account-and-plan)
- [Submit Your Title](https://help.filmhub.com/submit-your-title?hsLang=en#main-content)

    - [Prepare Your Deliverables](https://help.filmhub.com/submit-your-title?hsLang=en#prepare-your-deliverables)
    - [Upload, Submit, and Track](https://help.filmhub.com/submit-your-title?hsLang=en#upload-submit-and-track)
    - [Large Catalog Import](https://help.filmhub.com/submit-your-title?hsLang=en#large-catalog-import)
- [Quality Control (QC)](https://help.filmhub.com/quality-control-qc?hsLang=en#main-content)

    - [How QC Works](https://help.filmhub.com/quality-control-qc?hsLang=en#how-qc-works)
    - [Fix QC Issues](https://help.filmhub.com/quality-control-qc?hsLang=en#fix-qc-issues)
- [Pitching and Licensing](https://help.filmhub.com/pitching-and-licensing?hsLang=en#main-content)

    - [How Licensing Works](https://help.filmhub.com/pitching-and-licensing?hsLang=en#how-licensing-works)
    - [Avails and Pitching](https://help.filmhub.com/pitching-and-licensing?hsLang=en#avails-and-pitching)
- [Release and Delivery](https://help.filmhub.com/release-and-delivery?hsLang=en#main-content)

    - [Release Your Title](https://help.filmhub.com/release-and-delivery?hsLang=en#release-your-title)
    - [Marketing Your Title](https://help.filmhub.com/release-and-delivery?hsLang=en#marketing-your-title)
    - [Change or Remove a Live Title](https://help.filmhub.com/release-and-delivery?hsLang=en#change-or-remove-a-live-title)
- [Performance and Earnings](https://help.filmhub.com/performance-and-earnings?hsLang=en#main-content)

    - [Reports and Insights](https://help.filmhub.com/performance-and-earnings?hsLang=en#reports-and-insights)
    - [Getting Paid](https://help.filmhub.com/performance-and-earnings?hsLang=en#getting-paid)
- [Rights and Legal](https://help.filmhub.com/rights-and-legal?hsLang=en)
- [Services and Support](https://help.filmhub.com/services-and-support?hsLang=en)
- [For Channel Partners](https://help.filmhub.com/for-channel-partners?hsLang=en#main-content)

    - [Getting Started](https://help.filmhub.com/for-channel-partners?hsLang=en#getting-started)
    - [Finding and Licensing Titles](https://help.filmhub.com/for-channel-partners?hsLang=en#finding-and-licensing-titles)
    - [Delivery](https://help.filmhub.com/for-channel-partners?hsLang=en#delivery)
    - [Account Management](https://help.filmhub.com/for-channel-partners?hsLang=en#account-management)

[![Chill listening crop-3](https://help.filmhub.com/hs-fs/hubfs/Filmhub_Logotype.png?width=121&height=17&name=Filmhub_Logotype.png "Chill listening crop-3")](https://filmhub.com/)

<https://www.linkedin.com/company/filmhub/> <https://www.facebook.com/filmhubhq> <https://twitter.com/filmhubhq> <https://www.instagram.com/filmhubhq/> <https://www.youtube.com/filmhubhq>

Copyright © 2026, Filmhub