Marvia Developer Portal
DocsAPI ReferenceAbout
DocsAPI ReferenceAbout
  1. Docs
  • Getting Started
  • Authentication
  • Permissions
  • Filtering
  • Uploading Files
  • Using Marvia CDN
  • API Reference
    • Users
      • Get a user
      • Delete a user
      • Update a user
      • List
      • Create a new user
      • Get user locations
      • Update user locations
      • Get user groups
      • Update user groups
    • Products
      • List products
      • Get a product
      • Get product API module
      • Get product delivery module
      • Get product distribution module
      • Get product locations module
      • Get product files module
      • Get product stock module
      • Get product price module
      • Get product workflow module
      • Get product socials module
      • Get product internal comment module
      • Get product campaigns module
      • Get product permissions module
      • Get product reservations module
      • Get product template module
      • Get product form builder module
      • Get product variants module
    • Locations
      • Update a location
      • Get a location
      • Delete a location
      • List locations
      • Create a new location
    • Groups
      • Get a group
      • Update a group
      • Delete a group
      • List groups
      • Create a new group
    • Uploads
      • Initialize multipart upload
      • Complete multipart upload
    • Assets
      • List assets
      • Create a new asset
      • Get asset
      • Update an asset
      • Search assets
      • Get all meta tags
      • Get asset meta tags
      • Update asset meta tags
    • Posts
      • List posts
      • Get a post
  • Schemas
    • Schemas
      • LocationAddress
      • Location
      • Group
      • LocationLegal
      • nonEmptyString
      • LocationInvoice
      • Date
      • LocationContact
      • LocationMediaItem
      • HttpApiDecodeError
      • Issue
      • LocationCoordinates
      • PropertyKey
      • UnauthorizedError
      • LocationMedia
      • MissingPermissionsError
      • User
      • PartialLocation
      • InternalServerError
      • UserNotFoundError
      • UsernameNotUniqueError
      • TranslationSchema
      • EmailNotUniqueError
      • GroupItem
      • CategorySchema
      • TranslationLabelSchema
      • GetOneProduct
      • UpdateGroupsPayload
      • DefaultProduct
      • VariantParentProduct
      • VariantProduct
      • DateFromString
      • LocationNotFoundError
      • ProductNotFoundError
      • ProductApiModule
      • ModuleNotActiveError
      • ModuleIncompatibleWithProductTypeError
      • ProductDeliveryModule
      • DuplicateIdentifierError
      • ProductDistributionModule
      • GroupNotFoundError
      • ProductLocationsModule
      • DuplicateGroupNameError
      • ProductFilesModule
      • ProductStockModule
      • ProductPriceModule
      • UUID
      • ProductWorkflowModule
      • ProductSocialsModule
      • ProductInternalCommentModule
      • ProductCampaignsModule
      • ProductPermissionsModule
      • MetaTagCategoryDefinitionSchema
      • AssetNotFoundError
      • MetaTagDefinitionSchema
      • InvalidLocaleError
      • ProductReservationsModule
      • MetaTagOptionSchema
      • FileNotFoundError
      • ProductTemplateModule
      • ProductFormBuilderModule
      • AssetMetaTagsSchema
      • FormBuilderElement
      • MetaTagValidationError
      • ProductVariantsModule
      • PostNotFoundError
DocsAPI ReferenceAbout
DocsAPI ReferenceAbout
  1. Docs

Using Marvia CDN

Every asset on our platform has a shareable Content Delivery Network (CDN) URL that you can use on other platforms (e.g., CMS, PIM) to always display the most up-to-date version.
This link also supports Digital Asset Transformation (DAT), enabling adjustments to meet the needs of different platforms—such as specific file formats, resolutions, aspect ratios (crop), maximum file sizes, and backgrounds.

Reasons to Use#

Efficiency: You only need to upload the original, high-quality image once in the DAM. The CDN automatically handles all the necessary transformations for every destination, which saves you time and prevents manual errors.
Consistency: The CDN acts as a single source of truth. When you update an image in the DAM, it updates everywhere it's being used, ensuring you never have outdated visuals.
Performance: By using Amazon CloudFront, your content is delivered from servers close to each user, which reduces latency and significantly increases transfer speeds.

Possibilities#

Changes to an asset can be applied by adding parameters to the end of the CDN URL. For example:
https://cdn.getmarvia.com/...?format=avif&width=400&height=400&extend=50&background=white

Versions#

While the CDN URL contains the current filename, it will always display the latest version of the asset in the DAM—even if the updated version has a different filename or file type.

Parameters#

NameTypeDescription
formatstringFile format. Options: auto, jpeg, webp, avif, png, svg, gif
widthintegerWidth of the image in pixels
heightintegerHeight of the image in pixels
cropdecimal,decimal,decimal,decimalFour coordinates (in pixels) defining the crop area on the original file
extendintegerAdds padding (in pixels). Any integer above 0
backgroundstringBackground color. Supported: CSS color names (white), hex (without #, e.g. f0f0f0), RGB (0,0,0), RGBA (0,0,0,0.5) for transparency
qualityintegerRange from 1–100 (100 = best quality)
max-sizeintegerMaximum file size in bytes. Image quality is lowered to fit

Front-end Usage#

When viewing an image in the DAM, you can obtain the CDN URL by selecting the Crop & Resize button and copying the link. The generated URL will include parameters for width, height, and crop, depending on the applied adjustments.
image.png
Modified at 2025-11-20 06:15:40
Previous
Uploading Files
Next
Get a user
Built with