How to add an asset volume to Craft CMS

A step by step guide on adding an asset volume to Craft CMS.

Oscar de la Hera Gomez
Written by Oscar de la Hera Gomez
First published on 02/14/2023 at 18:11
Last Updated on 02/15/2023 at 10:40
A flower that represents Craft CMS with the text "Asset Volume" beneath it.

A step by step guide on adding an asset volume to Craft CMS.

SubscribeDownload Open Source Craft CMS project

We recommend checking out the main branch of our open source Craft CMS starter project and following the steps below.

git clone git@github.com:delasign/craft-cms-starter.git
View Repository

Step One: Create a Filesystem

A screenshot of the Create a new Filesystem Craft CMS page with a highlight on the selected bucket, which is left of the Refresh Button in the former step. We have also highlighted the save button on the top right. Once you have picked the right bucket, press the Save button and move on to the next step.

If you haven't already, create a File system.

We have provided a link to a tutorial below on creating an Amazon S3 Craft CMS Filesystem.

How to create an Amazon S3 Filesystem in Craft CMSLearn more about Filesystems

Step Two: Select Settings

A screenshot of the Filesystem Craft CMS page showing the newly created Amazon S3 File System. Highlighted is the Settings tab on the left menu side bar. Press it and move on to the next step.

In the left menu sidebar, select the Settings tab.

Step Three: Select Assets

A screenshot of the Settings Craft CMS page with a highlight on the Assets tile. Press it and move on to the next step.

In the Settings page, select the Assets tile under Media.

Step Four: + New Volume

A screenshot of the Assets Settings Craft CMS page. Highlighted is the + New Volume button. Press it and move on to the next step.

In the Asset Settings page, press the + New volume button.

Step Five: Fill in the details & Save

A screenshot of the Create a new Asset Volume Craft CMS page, highlighted are the details that you need to add including the name, handle and asset file system. This last one must match a formerly created asset system, or the one that you created earlier. We have also highlighted the Save button on the top right. Press this when reading to complete creating the asset volume.

In the Create new asset volume page, add a name and make sure that the Asset Filesystem is set to the volume you created.

Once you're done press Save.

Any Questions?

We are actively looking for feedback on how to improve this resource. Please send us a note to inquiries@delasign.com with any thoughts or feedback you may have.
SubscribeContact UsVisit our BlogView our ServicesView our Work

Partner with us

We would love to get to know you and see how we can help your organization with its goals and needs.
Let's Talk

Stay Informed

Get occasional updates about our company, research, and product launches.
Subscribe