Create an Asset

webflow.createAsset(fileBlob)

Create a new asset on your Webflow site.

This method is specifically for creating new assets - if you need to update an existing asset, use the set asset file method instead. Be sure to review the limits and MIME types sections to ensure your files meet the requirements.

Syntax

1
webflow.createAsset(fileBlob:File): Promise<Asset>

Parameters

• fileBlob:File - Represents a valid File to be uploaded. Refer to the examples below for guidance on uploading an asset from a remote source and directly from a file picker.

Returns

Promise<Asset>

A Promise that resolves to the new Asset.

Example

1
// Fetch image from remote source and build a Blob object
2
const response = await fetch(url)
3
const blob = await response.blob()
4
const file = new File([blob], fileName, {
5
  type: 'image/png',
6
})
7
8
// Create and upload the asset to webflow
9
const asset = await webflow.createAsset(file);
10
console.log(asset)

Errors

If the method fails to create an asset, the method will return an error with the following cause and message.

Designer Ability

Limits

Uploaded assets must adhere to specific size limitations:

• Images must not exceed 4MB
• Documents are capped at 10MB

MIME Types

Refer to the accepted MIME types listed below for compatibility. Lottie files should be passed as application/json MIME types.

'image/jpeg'
'image/jpg'
'image/png'
'image/gif'
'image/svg+xml'
'image/bmp'
'image/webp'
'application/pdf'
'application/msword'
'application/vnd.ms-excel'
'application/vnd.ms-powerpoint'
'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
'application/vnd.openxmlformats-officedocument.presentationml.presentation'
'text/plain'
'text/csv'
'application/vnd.oasis.opendocument.text'
'application/vnd.oasis.opendocument.spreadsheet'
'application/vnd.oasis.opendocument.presentation'
'application/json'