What this module is for

Use CMS / Assets to manage reusable media files that later appear in banners, pages, and other CMS-driven blocks.

Included units

• List: searchable asset catalog with list and gallery views
• Upload block: drag-and-drop one or more files into a selected repository prefix
• Create / Update modal: upload a new file, change the asset key, preview the current file, or replace the stored file
• Single delete: remove one existing asset from the edit modal
• Bulk delete: remove several selected assets from the catalog after confirmation

When operators usually open this module

• a new banner or page image must be uploaded before content editing starts
• an existing asset key should be renamed to fit a cleaner folder structure
• an outdated file should be replaced without changing all page references manually
• old or duplicate media should be removed from the shared catalog

Common confusion

• The page is for shared CMS assets, not for user documents or user card files. The catalog excludes user_document and user_card keys.
• Asset Name is the uploaded file name. Asset Key is the reusable internal path used by CMS content and should stay stable once it is in production use.
• Repository is not a separate database object. It is a prefix inferred from existing asset keys, plus any prefix an operator adds in the current upload session.
• New uploads normally cannot reuse an existing key. Use the edit modal when the goal is to replace an existing asset.
• Deleting an asset removes both the catalog row and the external stored file, so operators should confirm nothing still depends on it.