SR
Usage

Assets Import

Import asset volumes to organize your media files.


Columns

ColumnRequiredDescription
handleYesUnique identifier
nameYesDisplay name
fsHandleYesFilesystem handle (must exist)
subpathNoSubpath within filesystem
transformFsHandleNoFilesystem for image transforms (must exist)
transformSubpathNoSubpath for transforms
titleTranslationMethodNoHow titles are translated
titleTranslationKeyFormatNoCustom title translation key
altTranslationMethodNoHow alt text is translated
altTranslationKeyFormatNoCustom alt translation key

Example

handle,name,fsHandle,subpath,transformFsHandle,transformSubpath,titleTranslationMethod,titleTranslationKeyFormat,altTranslationMethod,altTranslationKeyFormat
images,Images,images,images,images,/images/transforms,Translate for each site,,Custom…,{{include('global/site.twig')}}
graphics,Graphics,graphics,,,,Custom…,{{include('global/site.twig')}},,

Prerequisites

The filesystem referenced by fsHandle must exist before importing asset volumes. Import filesystems first, then assets.

Transform Filesystem

Use a separate filesystem for image transforms to keep originals and transforms organized:

handle,name,fsHandle,subpath,transformFsHandle,transformSubpath
images,Images,assets,images,assets,_transforms/images

Translation Methods

Same as entry types:

ValueDescription
noneNot translatable
siteTranslate per site
siteGroupTranslate per site group
languageTranslate per language
customUse custom key format

Copyright © 2025 Samuel Reichör