Media library

The media library is the shared account-level repository for images, logos, and other files you use in your surveys. All users in your account see the same files. However, only users with the Manage Media Library permission enabled can add or remove files from the media library.

Browse and insert files

Users with access to the media library can browse all files and insert them into survey content, including answer choices; text and media elements; introduction and thank-you pages; survey banners and backgrounds; and email invitations.

  1. Open your survey and select the question, banner, or email invitation where you want to insert a file.

  2. Select Insert media.

    Insert media.

  3. In the media library, use the search and filter options to find the file. Then click Insert media.

  4. Click Save.

Upload files

To upload a file, you need the Media Library permission enabled. The media library supports these file types:

  • Images — jpg, jpeg, png, gif, svg

  • Office files — xls, xlsx, doc, docx, ppt, pptx, pps

  • Video — mp4, webm

  • Audio — m4a, aac, mp3

  • Other — csv, pdf, ics, ico

Images, video, and audio files can be shown or played in surveys. Other files can be linked so respondents can open or download them. Files can be up to 95MB.

Note: Do not paste an image directly into an email invitation. The underlying HTML becomes too large and the invitation will not send. Upload the image to the media library and insert it instead.

To upload a file to the media library, select Upload a File.

Upload a File.

Retrieve a file's URL

Certain tasks, such as importing variable banners or using custom CSS, require a file's URL. Select the file in the media library and the file name appears in the URL after files/ and before the file extension.

Delete files

To delete a file from the media library, you need the Manage Media Library permission enabled. Deleting a file removes it from the media library for users in your account.

Important: Surveys that contain the deleted file may be affected, so check where a file is used before deleting it.

To delete a file from the media library, select the file and click Delete. Agile Research asks you for confirmation before it removes the file from the media library.

Delete a file.

Manage Media Library permission

The Media Library permission controls who can make add and remove files from the media library.

  • With the permission enabled, users can browse, insert, upload, and delete files.

  • With the permission disabled, users can browse and insert files but cannot upload or delete them.

Users with the Report Viewer Only role do not have access to the media library.

By default, all new standalone Agile Research users will have the Manage Media Library permission turned on. All new Experience Cloud integrated users will have the permission turned off and must have the permission turned on explicitly via an account administrator.

Account administrators and user administrators can manage the permission in the Agile Research user admin page. The permission is not managed in Admin Suite.

  1. Select Account > Users to open the user admin page.

  2. Click Edit for the user whose permissions you want to update.

  3. In the Rights & Permissions section, turn the Manage Media Library permission on or off.

    Manage Media Library.

  4. Click Save.

Administrators can add the Manage Media Library permission for individual users through the user permissions API. Changes made through the API appear immediately in Agile Research. See the API documentation, specifically the "ManageMedia" permission.

Note: The Manage Media Library permission does not apply to files that respondents upload through a survey upload question or Media Capture. See Survey upload question for details.