Skip to main content
Version: 3.0.0-beta

Type Alias: StorageConfig

StorageConfig: object

Additional configuration related to Storage related fields

Type declaration​

acceptedFiles?​

optional acceptedFiles: FileType[]

File MIME types that can be uploaded to this reference. Don't specify for all. Note that you can also use the asterisk notation, so image/* accepts any image file, and so on.

fileName?​

optional fileName: string | (context) => string | Promise<string>

You can use this prop to customize the uploaded filename. You can use a function as a callback or a string where you specify some placeholders that get replaced with the corresponding values.

  • {file} - Full file name
  • {file.name} - Name of the file without extension
  • {file.ext} - Extension of the file
  • {rand} - Random value used to avoid name collisions
  • {entityId} - ID of the entity
  • {propertyKey} - ID of this property
  • {path} - Path of this entity

Param​

imageCompression?​

optional imageCompression: ImageCompression

Use client side image compression and resizing Will only be applied to these MIME types: image/jpeg, image/png and image/webp

maxSize?​

optional maxSize: number

Define maximal file size in bytes

metadata?​

optional metadata: Record<string, unknown>

Specific metadata set in your uploaded file. For the default Firebase implementation, the values passed here are of type firebase.storage.UploadMetadata

postProcess()?​

optional postProcess: (pathOrUrl) => Promise<string>

Postprocess the saved value (storage path or URL) after it has been resolved.

Parameters​

• pathOrUrl: string

Returns​

Promise<string>

previewUrl()?​

optional previewUrl: (fileName) => string

You can use this prop in order to provide a custom preview URL. Useful when the file's path is different from the original field value

Parameters​

• fileName: string

Returns​

string

storagePath​

storagePath: string | (context) => string

Absolute path in your bucket.

You can use a function as a callback or a string where you specify some placeholders that get replaced with the corresponding values.

  • {file} - Full file name
  • {file.name} - Name of the file without extension
  • {file.ext} - Extension of the file
  • {rand} - Random value used to avoid name collisions
  • {entityId} - ID of the entity
  • {propertyKey} - ID of this property
  • {path} - Path of this entity

storeUrl?​

optional storeUrl: boolean

When set to true, this flag indicates that the download URL of the file will be saved in the datasource, instead of the storage path.

Note that the generated URL may use a token that, if disabled, may make the URL unusable and lose the original reference to Cloud Storage, so it is not encouraged to use this flag.

Defaults to false.

Defined in​

packages/firecms_core/src/types/properties.ts:710

Sign up to our newsletter to get the latest news and updates. No spam!