In this chapter we will show how files can be organized and managed in Craft. Files are called assets, you can find them via the Assets menu. The most common files are images, but Word files, Excel sheets, PDFs and so on can also be uploaded.

Depending on the situation, files are stored into a folder on a specific location. Both the Craft test environment and the production environment might be using the same files. Therefore, it is important to know that deleting a file in the test environment can make it unavailable on the production environment and thus break your website.

# Page overview

Items that already have been covered in the chapter General operation of the overview page will not be described here anymore.


# Organise Assets

You can organise Assets easily by dragging and dropping them to a created folder of subfolder.

After moving an Asset to a different location the path changes automatically.

Keep in mind that making changes to the path of an Assets may affect findability!


Behind the name of the folder or supmap you will find an arrow pointing downward. This leads to a menu with options specific to the folder itself. For example, to change the folder name, create a new folder, move or delete it.

The folder name becomes active by clicking on it in the path, only then the arrow also appears.

Deleting a folder will cause all of it contents to be lost, without any warning!


# Viewing options Page overview

(regarding image block 1)

There are two different view options: listview or thumbnail view. You can find the button to switch views at the upper right corner.


# Uploading Assets

(regarding image block 2)

You can upload one or more local files at the same time to the Craft system with the button Upload files. Common supported file formats are PDF, PNG, JPG and SVG.


Files can also be uploaded without using this button. Simply drag and drop one or more files at a time into your browser window. The upload will start immediately.

The maximum size of a file that can be uploaded depends on the developer settings. Both Craft and the server where Craft is installed have their own limits. Usually, this is set to 16 MB per file. We recommend to keep the resolution of images as high as possible. In case of doubt or limitations, please contact the developer.

(regarding image block 3)

Go to chapter General operation of the overview page - Column view for a detailed description of how you can customise your menu.

Create folders and organise your images properly. Right-click on the menu to create a new subfolder.

# Adjusting assets

(regarding image block 4)

It is possible to edit or adjust files after uploading them to Craft. Tick the file you would like to edit and go to the cogwheel next to the language selection menu. Some options belong to installed plugins.

If you check multiple files at the same time, only the available options will appear in the menu.


# Preview file

Shows a preview of an image.

# Download

Tick one or more assets and choose Download to transfer them to your computer. Useful when you no longer have the original asset.

# Edit asset

Opens the detail page of the file. You can read more on this topic later on.

# Rename file

For a website visitor, the name of an image is also visible when it is downloaded. Therefore, it can be useful to have the possibility to change it without having to change the name of the file locally first.

# Replace file

Replaces the selected file with a new one. Images used in several places on your website can be replaced at the same time via one simple upload. In this way you don't have to delete them, upload new ones and go to each page separately to reset the path to the image again.

# Copy URL

Copies a link to the file in the clipboard. It gives you the possibility give it to someone directly.

# Copy reference tag

Every item has its own unique ID. Usually only used by Craft itself.

# Edit image

Opens the image in the Craft image editor. In this environment, you can do simple edits without needing a dedicated tool. Changes made are visible at every single place where this image is used.

Vector files (SVG) cannot be edited.


Turn images left or right in 90° increments.


Use mirroring to make the left side become the right side or the top become the bottom.

The degree wheel can be used to rotate an image in 1° increments.



The editor places a grid over the selected image. Grab the corner and drag it to change the size of the grid. Anything outside the grid will be cut away. It is also possible to choose a predefined ratio like square etc.


At the top you will find the option to orientate horizontally or vertically.


Focal Point

When cropping an image, you can choose to set a focal point. Choose Focal point and mark the place on the image where you want the focal point to be. By doing this Craft is able to use this focal point setting to automatically crop images. This gives you the advantage of not having to create and upload multiple variations in size of the same image.



Choose Save to apply the changes made or save as a new copy with Save as new material.


# Delete assets

Tick one or more images to be deleted. After this the cogwheel button appears, choose Delete.


# Detail page

Click on the title of the file to go to the detail page.


# Title

(regarding image block 1)

After uploading a file, the filename appears here as title. The title can be changed if desired.

# View & Save

(regarding block 2)

# View

Opens the image in a new window.

The View button only appears in case of an image.

# Download

Gives you the possibillity to save the asset to your local hard drive.

# Replace file

Replaces the selected file with a new one. Images used in several places on your website can be replaced at the same time via one simple upload. In this way you don't have to delete them, upload new ones and go to each page separately to reset the path to the image again.

# Save & Delete

After saving, all changes will be saved and you will return to the overview page. At the side of the button you can find a small arrow pointing down. Here you can find the options to save and continue editing or to delete the asset.

Use CTR-s to save and continue editing.

# Filename

If necessary, the name of the uploaded asset can be changed here.

Don’t forget to include the extension of the asset. Otherwise, this will result in an error message.

# File details

# Location

Shows the path to the location of an asset.

# File size

Shows the size of an asset.

Best to upload images in the highest quality if you’re using Imgix. But not larger than 16MB, which is the maximum for images in Craft.

# Uploaded by

Shows which user uploaded the file.

# Dimensions

Shows the size of an image.

The dimension section of an asset only appears in case of an image.

# Created at

Date and time of uploading.

# Updated at

Date and time of the last change made to the asset.

This user guide is brought to you by WHITE Digital Agency. Visit to see more of our work.