DocsAPI ReferenceAbout
DocsAPI ReferenceAbout
  1. Docs
  • Overview
  • Getting Started
  • Authentication
  • Permissions
  • Using the Marvia CDN
  • API Reference
    • Users
      • Get a user
      • Delete a user
      • List
      • Create a new user
    • Products
      • List products
    • 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 by UUID
      • Update an asset
      • Search assets
  1. Docs

Using the 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-08-13 10:33:56
Previous
Permissions
Next
Get a user
Built with