Aviary enables you to import resources in bulk through two methods: OHMS XML Import and Aviary Package Import. If you already have your descriptive metadata, media file paths, and transcript and/or index data packaged into OHMS, then you’ll find OHMS XML Import to be a quick and easy way to upload. If not, don’t worry — Aviary Package Import lets you upload your data through four or fewer spreadsheets for descriptive metadata, media files, transcripts, and indexes.

Adding a New Import

OHMS XML

Prepare your OHMS Files

Aviary allows you to import media files referenced in OHMS XML in two ways: from URLs on the web, or from an HTML media embed code. Your media files should be accessible to Aviary and listed in one of the OHMS XML elements listed in the OHMS-to-Aviary resource mapping.

OHMS metadata mappings can also be found in the OHMS-to-Aviary resource mapping. See “Resource CSV” below for more detail on Aviary descriptive metadata elements.

Import your files


Aviary package

Aviary allows you to import multiple media files at once from a zipped directory on your computer, using URLs for media on the web, or using HTML media embed codes. You can also import any associated transcript or index files, if available. You will need to prepare CSV files as outlined below to import any associated metadata and to tell Aviary where to find your media files. On import, Aviary will create new resources for each row in the Resource CSV and will then associate any connected media files to each resource. It also, optionally allows you to associate any number of  transcripts and/or index files with each media file.

Prepare your media files

Aviary accepts the following file types:


If you are importing files from your local environment, compress them into a single .zip file. (You may find it helpful to organize your files into separate subdirectories for media, transcripts, and indexes before zipping them all into a single file.)

If you are importing media from the Web using URLs or embed codes, follow the instructions below under ‘Media CSV file.’

Prepare your metadata files

Bulk upload using CSV files requires all data to be formatted following the Aviary metadata template (provided as a download from the Imports page). At minimum, you will need to create a CSV file describing your resources and a CSV file describing their corresponding media files. You may also include CSV files describing associated transcript files and index files. Media, transcript, and index files are all connected to the resource through the use of user keys (described in more detail below). These keys are used only for the import process, so they need only be unique for each import. Aviary does not store these temporary keys.

Resource CSV file

Using the template package provided on the Imports page, open the Aviary-resource-csv-template.csv file and enter metadata for your resources, one resource per row. Leave the “aviary ID” blank for now. Aviary IDs will be generated automatically by the system on import. (Note: Custom fields are not yet supported by bulk import.)


Media CSV

For each resource listed in the resource CSV file, you will describe the associated media files, one per row, in a separate CSV found in the same download package called Aviary-media-csv-template.csv. Leave the “aviary ID” blank for now. Aviary IDs will be generated automatically by the system on import.


Select one of the following fields for each row, depending on your file import method:


Finally, you will specify the order in which your files appear within the resource on Aviary with a sequence number:


Transcript CSV [optional]

Aviary currently accepts transcript files in OHMS XML or WebVTT format. If you are importing transcripts, you will describe each transcript file associated with a media file, one per row, in the Transcript CSV. (Currently, transcripts may only be bulk imported at the same time as Resource and Media file import. Bulk import of transcripts and indexes to existing Aviary resources will be available in a future release.)


Index CSV [optional]

Aviary currently accepts index files in OHMS XML or WebVTT format. If you are importing indexes, you will describe each index file associated with a media file, one per row, in the Index CSV. (Currently, index files may only be bulk imported at the same time as Resource and Media file import. Bulk import of transcripts and indexes to existing Aviary resources will be available in a future release.)


Import your files

Undo an import

If you need to undo an import for any reason, you can remove all imported resources and associated files by clicking the “Undo” button on the import’s entry on the Manage Imports page. This removes all resources and associated files listed in the import from your aviary account. Note that if you are making changes to your import files, you will need to remove the old import (with the “Remove” button) and create a new import for the changed files.

Related articles

Related articles appear here based on the labels you select. Click to edit the macro and add or change labels.



Related issues