Have you seen this sample project - GitHub - cuba-platform/sample-user-avatar: Adding avatars to system users? Note that extension of system user entity used only as an example, the approach is shown in the example can be applied to any entity. Just add an attribute with type FileDescriptor to your entity. Moreover FieldGroup component presents such fields using FileUpload components.