Skip to main content

Set up a media repository

This page applies to:MindTouch Responsive

This article outlines how to set up a MindTouch media repository for file management.

Why should I set up a media repository?

Set up a media repository to allow for ease of file management and avoid broken images if pages are deleted:

  • Reuse files throughout your site.
  • Update reused files in one central location.
  • Access files even after a page containing the files has been deleted.

Set up your media repository

Perform the following steps to set you your media repository:

Step 1: Install the media repository 

  1. Download the media repository MTARC file.
  2. Install the media repository MTARC file in each of your categories:
    • Click Options > Import here.
    • Find your media repository MTARC and select to import.

Due to file limitations, create a separate media repository for each of your categories

Step 2: Set permissions

In order to make the media repository accessible to your pro members but hidden to your end users, follow these steps:

  1. Click on the recently installed Media Repo.
  2. Click Options > Restrict access and select Semi-Private.
  3. Add any users or groups that will need access to the media repository to manage files.
  4. If you are creating subpages in your media repository categories, make sure to select Apply restrictions settings to all to subpages.

With your media repository set to semi-private, end users will be able to view images that are attached to that page, but the media repository pages won't show up in navigation or in search unless users are explicitly added to the permissions list. Review how to restrict access

Step 3: Identify a structure for ease of management

First, identify the structure of the documentation you are going to create. Mirror the organization within your categories to ease file management. 

If you are creating subpages, verify the appropriate access permissions are granted. To change permissions, see step 2.

Step 4: Add files

  1. Navigate to the bottom of the media repository page.
  2. Click Attach a file or drag and drop the files directly into the File table. 


MindTouch pages, including media repositories, will only display up to 100 file attachments. If you have a need for more than 100 file attachments in a media repository, we suggest creating sub-repositories within the parent repo as needed.

Step 4: Add files from the media repo to your pages

  1. Open the page into which you want to insert a file or image in Edit mode.
  2. In the editor toolbar, click the Image icon Screenshot of image icon.
  3.  Browse to your media repository or search by the file's name.
  4. Click Save image.

What's next

Learn how to add images to your pages.  If you have any questions about the best way to structure the media repository, please feel free to reach out to our support team.  

  • Was this article helpful?