Operator guideENcmsassetslist

CMS / Assets / List

Searchable asset catalog with upload, replace, rename, preview, and delete flows for CMS media.

Reader view

Clean portal guidance

This page keeps the operator explanation, field and action descriptions, and screenshots visible without exposing repo paths, raw sidecars, or editorial-only implementation details.

Narrative content

Page body

What this page shows

This page is the working catalog for CMS media. Operators use it to find reusable files, upload new assets, open an existing asset in the edit modal, and remove obsolete media.

When to use it

  • search for an image that should be reused in a banner, page, or CMS block
  • upload a new file into the shared asset library
  • replace the file stored under an existing asset key
  • clean up duplicated or obsolete media
  • confirm the final internal asset key before other modules reference it

How to read it

The page supports two operator views:

  • List view: shows the core fields needed for search and audit
  • Gallery view: shows image previews and supports bulk selection more comfortably

The main catalog columns are:

  • ID
  • Image
  • Name
  • Key

Row click opens the asset modal, where operators can update the file or rename the key.

Filters that change the result

  • Search: matches asset name, key, or asset URL

Known caveats

  • The backend excludes keys that contain user_document, so this page is not a complete file dump of every stored image.
  • Uploading a file to an existing key replaces the previous asset row for that key.
  • Changing the key is blocked if another asset already uses that key.
  • Bulk delete is destructive and also removes the external stored file, not just the visible row.

Verification status

  • status: verified_backend_and_core
  • FE mapping checked from the asset page, list, upload block, and asset modal
  • core read and mutation routes checked in the asset controller family
Field dictionary

Fields

field

ID

Internal asset identifier used for update and delete operations.

Data Type
integer
field

Image

Opens the current stored image so operators can confirm the file visually before reuse or replacement.

Data Type
asset-preview
field

Name

Original uploaded file name shown for quick recognition.

Data Type
string
field

Key

Reusable internal path used by CMS content and other admin forms to reference the asset.

Data Type
string
Filter dictionary

Filters

field

Search

Filters the catalog by asset file name, internal key, or asset URL.

Type
text
Operational notes

Notes

item

FE mapping confirms list and gallery modes, upload flow, row click to modal, and bulk delete behavior.

item

Core asset search excludes keys containing `user_document`.

item

Upload replaces an existing row when the same `assetKey` is reused.

Related references

Related pages

pageCMS / Assets

Operator guide for the CMS asset library used to upload, organize, update, and delete reusable media files.

pageActivity Tag Rules / List

Main inventory for activity-driven tag rules, with search, activity and status filters, grouped rows, clone, edit, and run actions.

pageAffiliate Deals / List

Searchable table of affiliate deal rows with PID filter, create action, dashboard shortcut, and edit/delete row actions.

pageAffiliate Payment Settings / List

Affiliate payment settings inventory page for reviewing configured rows and opening saved records.

pageAffiliate Settings / List

Affiliate inventory list used to review saved affiliates and open detail or report flows.

pageAuto Tags Manager / List

Rule inventory with search, direct navigation to create or reorder, row-level run controls, and job history or recovery actions.