Image libraries

The Images page lets you create and maintain libraries for the images that you upload. There, you see the number of images in each library, the date of the last uploaded image, and where those images are stored.

1. On an Images page, click Create a library.
   The Create an image library page opens.
2. Enter the name of the library.
3. To add a description of the library, click Click to add a description.

   NOTE: The information you provide here is not public, it is for your reference only.

4. Under URL name of the library.
   The automatically generated URL of the library appears.
   To change it, click Change and enter a preferred URL name.
5. Under Put this library..., choose where to create the library:
   Select one of the following:
   • On top level
     This will be a top level library that has no parent.
   • Under parent library…
     A popup with recent libraries opens. If you cannot find the desired library, click Show all libraries.
     Select the library branch level that will be the parent of the library you are creating.
     A library you are creating will be located within another library, and assumes the settings of its parent.
     You can change the parent library. To do this, click (Edit).
6. If you specified your library as a top level library, under Storage provider, you select whether images are stored in a database or in the file system. For more information, see Storage providers for libraries.
7. Click Create.

1. In Sitefinity CMS backend, navigate to Content » Images.
2. Select the library you want to edit.
3. Click the Actions button, and then choose Library properties.
   The Edit an image library page opens.
4. Make your required changes.
   

   NOTE: If you are changing the URL of the library, Sitefinity CMS changes the URLs of the items one by one. In case of external storage, changing the library URL may cause data transfer from one storage to another. In case of failure, some of the items might keep their previous URLs and some of the items will have the updated URLs. You can try to resume to get the rest of the items relocated.

   To rename the library, change its Library name.

5. Click Save changes.
   The system returns to the Images page.

You can expand Advanced options to configure the following:

• Resize images on upload to width no larger than...
  Use images as uploaded or scale them to each fit within a selected size limit.
• Caching options
  Caching typically increases performance. Select from the following for what you want for optimal caching:
  • As set for the whole site.
  • No caching
  • Standard caching
  • Long caching
  • No explicit caching
  For more information about caching, seeCache settings.
• Thumbnail sizes
  Images can be displayed as thumbnail of original images that the user clicks to expand them to full size. You can choose one or more thumbnail sizes for each image in the library. In an existing library, choose the library's Actions item Thumbnail settings. For more information, see Settings for images.
• Max album size
  Constrain the library to a specified integer number of megabytes (MB).
• Max image size
  Constrain the images to a specified integer number of kilobytes (KB).
• Storage provider
  Select whether images are stored in a database or in the file system. For more information, see Storage providers for libraries.
  

Once created, a library can be moved together with all of its content to another library by changing its parent library.

To do this, perform the following:

1. In Sitefinity CMS backend, navigate to Content » Images.
2. Select the library you want to edit.
3. Click the Actions button and from the dropdown, select Move to another library…
   The Move to another library screen opens.
4. Select the new parent library and click Move.

IMPORTANT: To move your library on the top level, instead perform procedure Edit and rename image libraries, and in Step 4, select Put this folder... » On top level and save the changes. 

You can change the storage provider of a library, which moves all items in a different storage. For example, an image library kept in the database can be moved to the cloud, or a library from one cloud account can be moved to another.

PREREQUISITES: Your library must be on top level.

To do this, perform the following:

1. In Sitefinity CMS backend, navigate to Content » Images.
2. Select the library you want to edit.
3. Click the Actions button and, from the dropdown, click Library properties.
4. Expand Advanced options, and in the Storage provider select where you want to move the library.

NOTE: To use a CDN storage, you must configure the CDN storage provider. For more information, see Use CDN storage for content libraries.

5. Click Save changes.

Sitefinity CMS processes the library items one by one. It displays a progress bar in the grid.
You can Stop and Resume the operation.

Transfer failure

If one or more of the images cannot be transferred, they are skipped, and the system continues to process the rest of the images.

In this case, the system displays a Failed indication and you have the following links:

• Details link
  When you click it, you can see a lists of all images that failed to transfer.

  NOTE: For more information, you can check the Error.log file that is located in your project's ~\App_Data\Sitefinity\Logs folder.

• Restart link
  The system will attempt to transfer the images that failed.

IMPORTANT: During the process of moving to another storage, you are not able to edit or delete any library items.

For more information, see Storage providers for libraries.

To delete a library, perform one of the following:

• On Images page, select the library you want to delete.
• Click the Actions button, then click Delete.
  

A dialog opens for you to confirm the deletion.