Uploading Images

Reservoir includes a file manager for uploading images. Read on for instructions on how to use the image uploader and for best practices in organizing your images.

Using the Image Uploader

There are a few different ways to access the images section of your Reservoir site.

  • In the admin, under CMS > Files.

  • When editing HTML content, click the Image button and then click the Browse Server button.

  • When editing HTML content, click the Link button, then the Browse Server button.

  • When editing certain dynamic content, you may be provided with an Image field (or even multiple Image fields). The recommended path with this option is to click the Select a File link underneath the image upload field because it gives you fine-grained control over how your image is uploaded. (See directly below.)

    Always click the "Select a File" link when uploading images.

Once you have the image uploader open, you can browse to different folders on the left side of the screen. You then (1) use the File field to choose a file to upload and (2) click the Upload button to upload the file to the server.

You can also (3) create new folders using the New folder button in the upper right corner.

After uploading the image, find it in the folder, click it, and click the Select button to insert it into your content.

If the image you want to use is already uploaded to the server, you can click on its icon and click the Select button. We recommend reusing images wherever you can on your site to avoid having duplicate content stored on the server (which is harder to maintain over the long-term).

Resizing Images

We do not recommend changing the image dimensions in the Image Properties dialog. If you increase the dimensions (width or height) larger than the original image, the image will be stretched and will become blurred (or pixellated). If you resize the image smaller, you force your users to download an image that is larger than you intend to display. While the image appears smaller on the screen, the user actually downloads the original (larger) image. This is wasteful of your users' time.

If you need a larger or smaller version of an image that you uploaded to Reservoir, you'll need to do the resizing in a program like Photoshop or Fireworks, then upload the new version to Reservoir.

If you are looking for free image editing software to do basic image manipulation, we recommend Aviary Phoenix (online) or GIMP (downloadable).

Tip: Organize Your Images into Folders

As you add image files to your Reservoir site, you'll soon recognize that maybe you should have taken some time up front to come up with a way to organize those images. Here are some strategies for organizing images into folders.

Basic Folder Structure

Out of the box, a basic folder structure has usually already been set up for you within the Images area of your File manager. Most of the time, you will not be concerned with the background/ folder because it stores images used for design and decorative purposes.

The content/ folder contains most of the images that you care about and will work with. We recommend using this folder for "common" images that will be used prominently around the site. Good examples of items that belong in this folder are your logo, staff photos, and other common images.

Organizing Beyond the Basics

Uploading all of your images directly into the content/ folder usually isn't the best idea though, especially if you plan on running an active blog, articles section, or other types of dynamic content within Reservoir.

With that in mind, you should consider creating additional subfolders with structures similar to these 3 suggestions.

Scenario 1: Grouping Related Images into Folders

If you have a group of related images that you will be uploading to Reservoir, you may consider creating a folder for them as you're uploading.

Consider adding folders for products/, staff/, partners/, icons/, and so on.

Scenario 2: Organize by Article Titles

  • Images/
    • background/
    • content/
      • articles/
        • an-articles-title/
          • smiling-lady.jpg
        • another-article/
          • wall-street-figures.gif
          • busness-man.jpg
      • ceo-bio-photo.jpg
      • company-headquarters.jpg
      • dancing-zebra.jpg
      • logo.png

Under this structure, you can drill down into the articles/ folder, then the title of the article, to get to the images for that article. When creating a new article, just add the new subfolder before uploading the first image.

Scenario 3: Organize by Year and Month

If you plan on having a very active blog, for example, then another organization scheme that you should consider is organizing folders by year and then month.

So we could order a blog/ folder to look more like this:

  • Images/
    • background/
    • content/
      • blog/
        • 2011/
          • 12/
            • cat1.jpg
            • cat2.jpg
        • 2012/
          • 01/
            • cat3.jpg
            • cat-playing-with-yarn.png
      • ceo-bio-photo.jpg
      • company-headquarters.jpg
      • dancing-zebra.jpg
      • logo.png

When organized like this, you can quickly drill down into years and then months to find images. When creating your first blog post for a new month and/or year, you can create those folders before uploading the new image.