Supplemental Files 🆕
Search
What are supplemental files?
Audiovisual content often requires additional context to provide a complete experience for researchers and users viewing the media.
Aviary allows organizations to attach supplemental files that are associated with audiovisual content directly to their resources. These supplemental files act as supporting documents — including images of interviewees or digitized media carriers, PDF files like presentation slides or notes, or scanned documents such as consent or release form — that are associated with a specific Aviary resource.
This user guide provides more information about how to import, manage, restrict, and provide access to supplemental files for the resources in an Aviary organization.
Supplemental file formats
Aviary supports the following supplemental file formats:
Images: JPG, PNG
Documents: PDF
Viewing supplemental files
1. Supplemental images and PDF files associated with a specific resource are displayed in the Supplemental Files tab when viewing the Resource Detail page.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/org_57036292338d4d32aa1d4309119769fa/team_3db239a63b014350b6503635bfaa0d83/document_3b822cb0c3874a71acf256f926954a4c/steps/step_f3862be15bb542ea8cbab89f9545be85_3e5d6a99f47a4683a1ecbca3498b99d7_3eba22d857ca4829bbc3e59083f8beff_text_export.jpeg
2. Multiple supplemental files may be associated with a resource. If multiple supplemental files are available, users may choose which file to view from the Supplemental Files dropdown menu.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-06/3c36d8a9-0b12-45d7-aa18-0d0b54b2e399/sps-redacted-69de71bf9457442f85dc5b2ea6e486f5_337e8ea9884c444f9abebd86ec7846de_text_export.jpeg
3. Descriptive metadata about each supplemental file, including the Title and Description, is also displayed in the Supplemental Files tab.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-06/7175fdf6-028a-42bc-a6af-6ee80a1ec8da/sps-redacted-cef67bdf1dc84728b2069a82e6c82d74_8a67f1d6931b4c6b89f6fd91cc86d0ba_text_export.jpeg
4. Users can search for specific terms in the supplemental file metadata or searchable PDF documents using the Search this Resource bar. Type a search term and press Return or Enter to search the resource.
https://colony-recorder.s3.amazonaws.com/files/2026-04-07/42114a94-b159-4198-8cb3-7064c88f2ddf/sps-redacted-7c4e4e3898734e2ebc37fc86ddc0b928_cfbd377aa6bc4ab48f72973c3b1d84db_text_export.jpeg
5. The search term will be displayed below the search bar with the number of results listed in each tab.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/42b9f64d-1c16-46ee-8932-60e6c2319f47/sps-redacted-77f16e5664964319a29a6c3e346f247b_ce5dbd2dce4e45d29cc549b56af98260_text_export.jpeg
6. If multiple supplemental files are associated with a resource, select the file with hits for the search term from the Supplemental Files dropdown menu.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/0a1e2fec-b897-4036-a498-ffa36c4c9bc9/sps-redacted-9f3c393f2d4d4682b4234a1a110681e1_90d4dc6e1e35475e85e585a11dd47194_text_export.jpeg
7. The search term will be highlighted if it is in the Title or Description fields. If the supplemental file is a searchable PDF, the total number of search hits in the file will also be listed. Continue viewing the PDF in the Supplemental Files tab or download the file to search and review the PDF in more detail.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/2b536efd-413a-406e-b35d-1cc98415b39e/sps-redacted-eb56e097aa3e4bee99787e1b7acb82de_afd8c85693ec4ab6ac870d64109a615e_text_export.jpeg
Importing supplemental files
Supplemental files can be added to resources using several methods including manually uploading files in the user interface, bulk import options, and the Aviary API.
Follow the instructions below to manually import supplemental files to Aviary resources.
For more details about using bulk import options or the Aviary API to import supplemental files, please refer to the Bulk Importing and Aviary API documentation.
Manually uploading supplemental files
1. To manually upload a supplemental file, click the vertical ellipsis (⋮) in the Supplemental Files tab and select Upload Another Supplemental File from the dropdown menu.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-06/b5b391fe-181b-44f7-9817-839e3547b537/sps-redacted-e23ab5279e8547c4a17539e1229f35cb_c3a98e5c9644463f819869a6a250613c_text_export.jpeg
2. The Supplemental File modal window will open. Click the Select File field and choose a supplemental file to upload from local storage.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-06/d451760f-176d-4f43-a4e7-a99c1b579ad4/sps-redacted-b1e0f3e603264db5949e84eea3785498_f14cb49a974544a1ad7a860d5f31dbc4_text_export.jpeg
3. After selecting supplemental file to upload, the file name will be displayed below the Select File button.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-06/313a1cf9-b111-4d9d-b9f9-e505a73a3a30/sps-redacted-5ecaa58c33dc48d0af022efe10a7e7f4_edce3f23cdce475e9166b55187cff45e_text_export.jpeg
4. Enter a title for the supplemental file in the “Assign a Title to this Supplemental File” field.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-06/313a1cf9-b111-4d9d-b9f9-e505a73a3a30/sps-redacted-5ecaa58c33dc48d0af022efe10a7e7f4_320be813811c45fa9c4de02c62c1f67a_text_export.jpeg
5. Enter a description for the supplemental file in the Description field.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-06/d7ed3dfb-c7ae-425b-a01b-216d809b8c1b/sps-redacted-678645f48256404492c185fdb95f2ccb_6a29c969408c48caa303f0a908cbba32_text_export.jpeg
6. Select whether the supplemental file should be public or private in the “Public?” dropdown menu.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-06/5fdac2a2-34af-40f5-87b6-0c0c02db36b2/sps-redacted-3466b8c02d01462ab038fd18539ff527_48a192e98081496a93ec2b87fb5c1397_text_export.jpeg
7. Click the Upload Supplemental File button.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-06/4998de1d-7591-43db-99f7-b2496b7848bd/sps-redacted-79c024da51e8465ebe7154f14e23532b_d6be58384ae04d4db272f2c0ed692d3f_text_export.jpeg
8. The Resource Detail page will be displayed after the supplemental file has been uploaded. If the resource contains multiple supplemental files, use the Supplemental Files dropdown menu to choose which file to display.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-06/1112bc01-6092-4a6a-94ac-78acd7dc82f4/sps-redacted-36baa4aac4f04b4ab38f70cea4ed1bb0_3ca3c5abf79f452e8985a7c2af25f7ce_text_export.jpeg
9. The uploaded supplemental file and metadata will be displayed in the Supplemental Files tab.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-06/9ae48bfc-1e7a-4c7d-8a77-5b024d8e3b17/sps-redacted-8c827283f1f846528371644d1cf9c8f7_137e9d282b9143488ad41bb4fbfbca4c_text_export.jpeg
Editing supplemental files
Updating supplemental file display order
1. To update the display order for a supplemental file, click the vertical ellipsis (⋮) in the Supplemental Files tab and select Manage Supplemental File from the dropdown menu.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/8a13cfff-b867-4875-9e92-e0f544504952/sps-redacted-0d0f5acedeaf41d0845973d63e15ac17_427366c8bb1d43278e2f7095b77a1ef5_text_export.jpeg
2. The Supplemental File Management modal window will open. Click the icon beside a supplemental file and drag the file to change its order in the list.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/797819fd-eb02-46cc-b8de-92787d269a8e/sps-redacted-1cc8e8e02b6246a0b1333d823c46c5a5_873d031b29714d439aa6633e27f97f04_text_export.jpeg
3. Click the Save Sequence button to save the updated display order. The supplemental files will be displayed in the updated order when viewing the Supplemental Files dropdown menu on the Resource Detail page.
https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/0fc8f544-79c1-4ce2-9ea0-9f52b8b63b07/sps-redacted-5fe3868633a24cae82e34bd7b505c02f_680cbd1edfe24e7a812a688a853f9d24_text_export.jpeg
Editing supplemental files and metadata:
1. To replace an existing supplemental file or edit its metadata, click the vertical ellipsis (⋮) in the Supplemental Files menu tab and select Update this Supplemental File from the dropdown menu.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/ec354669-a1e2-48d3-b653-62bd3a0fb25a/sps-redacted-87e14ad5c88b4ea89fabc47c4066751b_727df1b98e4a4b07bd43f225860081c1_text_export.jpeg
2. The Update Supplemental File modal window will open. To replace the current supplemental file, click the Select File field and choose another supplemental file to upload from local storage.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/3b050b71-9fbe-48ca-909a-70dbc21546c4/sps-redacted-1d9bfb6c64064d889a99caed9912c4b5_718ec36c7c5a47ad8f500c3df87b8d30_text_export.jpeg
3. Edit the title in the Assign a Title to this Supplement File field.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/40dbfbcb-5af4-4f7e-9e54-a1a9cb6af34a/sps-redacted-8efcb4af35b4490fbceb89c57c82c5db_47049be0859646ad8abc391f59d2d652_text_export.jpeg
4. Edit the description in the Description field.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/40dbfbcb-5af4-4f7e-9e54-a1a9cb6af34a/sps-redacted-8efcb4af35b4490fbceb89c57c82c5db_3fa79b840df443e4958c8a4ea9a214d7_text_export.jpeg
4. Select whether the supplemental file is public or private in the Public? dropdown menu.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/2201167a-d32e-4e25-a70c-f401df779479/sps-redacted-61aa56c0448441a7aaaa01dd7371ca27_72e3bddedb6b4e7f92a556bc8a109dd9_text_export.jpeg
5. Click the Update Supplemental File button to save changes to the supplemental file and its metadata.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/da71467f-6d8e-4d07-bf35-234b6884c4c7/sps-redacted-64d2f76915394ebcbae5478e781680e3_6383207643df42b0843874f2a2b7696c_text_export.jpeg
Bulk editing supplemental files
Bulk editing supplemental file settings
1. To bulk edit the settings for multiple supplemental files, click the Supplemental Files link in the admin menu. All of the supplemental files in an organization will be listed in the Supplemental Files table.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/70ebc00d-33d7-4e18-a69b-2c06df23c626/sps-redacted-be6207c6d8c649968fdd508dc7106d0f_b7f3db78349046dea6537811565ecaa5_text_export.jpeg
2. Check the boxes beside individual supplemental files, or check the checkbox at the top of the column to select all of the supplemental files currently displayed in the table.
The number of selected files will be shown above the table. Users can also use the Search box above the table to filter and select specific files.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/9bc1a523-c864-4c60-bd40-09451c0a0211/sps-redacted-320336ef5d244221bd15026f701ff20d_7682fd4368cd40179f9b8a5c0b746b8f_text_export.jpeg
3. To select all of the supplemental files in an organization, click the Select All link.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/237d7499-b369-4ddf-b45f-202f151d5d73/sps-redacted-a2ee94e225f143c290c0879d8bec8b30_bd1846f29edb4e10b90a3f6747dfe34c_text_export.jpeg
4. To clear the selected supplemental files, click the Clear Selected link.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-09/52ba75cb-ca1f-4f87-9056-489a596cabee/sps-redacted-c74bc0551c5e4c6e9d3951653d72646b_0ea99781545d45748844dc47dad6480b_text_export.jpeg
5. Click the Table Options button and select Bulk Edit Options from the dropdown menu.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-10/222ed434-63ea-4fe2-876a-2692a0ea6e7c/sps-redacted-d61fe4e12771410cb4e8117039bfd3c9_e176bf6ddc9e49358dd088e7b69e3016_text_export.jpeg
6. The Bulk Edit modal window will open. Select a bulk edit option from the first dropdown menu.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-10/1861d882-d481-4d70-bb01-75ade4db4a39/sps-redacted-7019960810f941bd87ff57f7ebddfd1a_d3450c6d7875499a94e0efc6f9ae996e_text_export.jpeg
7. If required, complete any additional fields for the bulk edit option.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-10/9d384652-e7af-466b-841b-268f3dc99d54/sps-redacted-f4726b8428f64f35b15a21ac2b53a064_ff358c38e3444f569c649c8855d3333d_text_export.jpeg
8. The number of supplemental files to be updated will be displayed at the bottom of the window. Click the Apply button to continue.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-10/d0cb0543-51c3-4505-bccc-ffc54bcac995/sps-redacted-ab5d534072fd45a48848685559313ef0_d1509d30ddad45029d3e8b949c2d70e3_text_export.jpeg
9. The Bulk Edit Review modal window will open. Review the list of supplemental files to be updated. Click the Apply button to finish submitting the Bulk Edit request.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-10/c55fc1fe-15c8-414b-9443-a77a81924b4c/sps-redacted-24f3a911be2c4d56af8dac43404e04cb_594d39bb0ebb4ab48238dee24289fb32_text_export.jpeg
10. A confirmation message will be displayed above the Supplemental Files table when the files have been updated.https://colony-recorder.s3.us-west-1.amazonaws.com/files/2026-11-10/74866958-dda2-452f-856d-6a28ac3cb4ef/sps-redacted-6c009448567142f2ba4b887c1cf63434_8c3d45ba1134478183b3d89e4f37153f_text_export.jpeg
Bulk editing supplemental file metadata
The metadata for supplemental files can be bulk edited by importing a CSV file that contains the updated metadata and identifiers for each supplemental file.
The process is similar to bulk editing resource metadata but involves exporting and importing a supplemental file metadata CSV from the Table Options menu in the Supplemental Files table.
For more information about bulk editing metadata, please refer to the Editing resource metadata section of the Resources documentation.
What are supplemental files?
11/05/2026
Audiovisual content often requires additional context to provide a complete experience for researchers and users viewing the media.
Aviary allows organizations to attach supplemental files that are associated with audiovisual content directly to their resources. These supplemental files act as supporting documents — including images of interviewees or digitized media carriers, PDF files like presentation slides or notes, or scanned documents such as consent or release form — that are associated with a specific Aviary resource.
This user guide provides more information about how to import, manage, restrict, and provide access to supplemental files for the resources in an Aviary organization.
