CORE MODULE

Manage Images and Other Assets

What you'll learn in this guide

How to host images, fonts, and other files for use in your forms — and how to reference those hosted assets in your form CSS and templates.

Overview

CX Platform forms are delivered as web pages, which means any images, fonts, or other files you want to use in them need to be hosted at a publicly accessible URL. CX Platform doesn't have a built-in media library in the Receive module — instead, assets are hosted via the Send module, where they're uploaded and served from your tenant's Content Delivery Network (CDN).

Once an asset is uploaded and hosted, you reference it by its CDN URL — in your form CSS, in HTML components in the Form Designer, or in the Default survey CSS settings.

‍

How asset hosting works in the Send module

Asset hosting in the Send module uses the Application structure. Each Application has an assets folder where you can upload files and get a hosted CDN URL for each one.

You can use an existing Application for this purpose, or create a dedicated one specifically for hosting shared assets like logos, fonts, and background images. A dedicated assets Application keeps things organised and easy to find, especially if the same assets are used across multiple forms.

For detailed steps on setting up an Application and uploading assets, refer to the Send module setup and Applications documentation.

‍

Common assets used in forms

  • Logo — the logo displayed on published forms is set via the --cx-logo-url variable in the Default survey CSS. The value needs to be the full CDN URL of your hosted logo image, wrapped in url("...").
  • Custom fonts — self-hosted font files (.woff2 and .woff) are uploaded to the Send module and referenced via @font-face blocks in the Default survey CSS. See the Add Custom Fonts to Your Forms guide for setup details.
  • Images in forms — images used inside form content are added via the Image question type in the Form Designer. Paste the CDN URL of your hosted image directly into the image source field.
  • Images in HTML components — if you're using the Html question type to add custom content blocks, you can reference hosted images in the HTML using a standard <img src="..."> tag with the CDN URL.
  • Background images — background images for the form page or form card can be referenced in the Default survey CSS using standard CSS background-image: url("...") syntax with the CDN URL.

‍

URL format

CDN URLs for assets hosted in the Send module follow this pattern:

https://yourtenantname-cdn.cxengine.com.au/resources/yourapp/t/1/filename.ext

Copy the URL from the asset in the Send module and use it directly wherever you need to reference the file — in CSS variables, HTML attributes, or @font-face blocks.

‍Keep assets organised: Consider using a consistent naming convention for your asset files — for example, prefixing logos with logo-, fonts with font-, and images with the form name or category. It makes URLs more readable and assets easier to manage as your library grows.

‍

All the pieces come together in the Send module — upload there, copy the URL, and reference it wherever you need it in your forms. For Application setup instructions, see the Send module setup and Applications documentation.

‍