Homepage

Asset

Last edit: Oct 13, 2026

Static file (image, stylesheet, script, font etc.) from app/assets or a module assets directory, served from the CDN

type Asset implements AdminSharedAttributesInterface {
  content_type: String
  created_at: JSONDate!
  deleted_at: JSONDate
  file_size: Int
  id: ID!
  manually_managed: Boolean
  metadata: HashObject
  name: String!
  physical_file_path: String
  updated_at: JSONDate!
  url: String!
  virtual_deleted_at: JSONDate
}

Fields

content_type (String)

MIME type of the file, for example image/png

created_at (JSONDate)

Timestamp of when the object was created, set automatically by the system

deleted_at (JSONDate)

Timestamp of when the asset was soft deleted, for example because it was
removed from the project and deployed; null for an existing asset

file_size (Int)

File size in bytes

id (ID)

Unique identifier of the object

manually_managed (Boolean)

When true, the resource is managed outside of files: pos-cli deploy and sync never overwrite or delete it

metadata (HashObject)

Free-form data attached to the resource with the metadata key of its file (or the metadata argument of an admin mutation)

name (String)

Path of the asset relative to the assets directory, for example
images/logo.png; module assets are prefixed with modules/<module name>/, for
example modules/my_module/app.css

physical_file_path (String)

Path of the file the resource comes from, relative to the app directory, for
example views/pages/index.liquid or
modules/my_module/public/views/partials/header.liquid. Identifies the resource
in deploy, sync and admin mutations

updated_at (JSONDate)

Timestamp of when the object was last updated, set automatically by the system

url (String)

Public CDN URL of the file, with a cache-busting updated parameter that changes when assets are deployed

virtual_deleted_at (JSONDate)

Deprecated, use deleted_at instead

Interfaces

AdminSharedAttributesInterface

Attributes shared by resources that can be deployed from files with pos-cli
(pages, partials, layouts, notifications, authorization policies, schemas, assets etc.)

Questions?

We are always happy to help with any questions you may have.

contact us