I created a media image field in my custom entity content:

$fields['image'] = BaseFieldDefinition::create('entity_reference')
  ->setLabel(t('Promotion image'))
  ->setDescription(t('Recommended image size is 1600x900 pixels.'))
  ->setSetting('target_type', 'media')
  ->setSetting('handler', 'default:media')
    'handler_settings' => [
      'target_bundles' => [
        'image' => 'image',
      'sort' => [
        'field' => '_none',
      'auto_create' => FALSE,
      'auto_create_bundle' => '',
  ->setDisplayConfigurable('form', TRUE)
  ->setDisplayConfigurable('view', TRUE)
  ->setDisplayOptions('form', [
    'settings' => [
      'entity_browser' => 'image_browser',
      'field_widget_display' => 'rendered_entity',
      'field_widget_edit' => TRUE,
      'field_widget_remove' => TRUE,
      'open' => TRUE,
      'selection_mode' => 'selection_append',
      'field_widget_display_settings' => [
        'view_mode' => 'default',
      'field_widget_replace' => FALSE,
    'type' => 'entity_browser_entity_reference',
    'weight' => 3,
  ->setDisplayOptions('view', [
    'label' => 'hidden',
    'settings' => [
      'target_type' => 'media',
    'weight' => 3,

Even though the entity itself, and the field are set to translatable, the ALT and TITLE attributes of the image are not translated.

If I create this field manually in the UI, it works as intended, and gets translated. How could I define this field to be translatable programmatically?

  • What are you trying to do? Translating the reference field means you need to replace the media item with a translated version, but it looks more like you want to keep the media item and translate ALT and TITLE in the media entity. – 4k4 Mar 3 at 10:56
  • Good catch, thanks. I intend to make the media image translatable as a whole entity, the image, the ALT and TITLE attributes... Current code example doesn't do that though. This is as much as I could gather from the config files when I manually added and configured the media field as such. Seems i'm missing some more. Any ideas? – osman Mar 3 at 17:55
  • 1
    I wouldn't make the reference field translatable then. This can be quite confusing if you have already configured the media type including the image field with the file, title and alt property as translatable. – 4k4 Mar 3 at 18:59

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Browse other questions tagged or ask your own question.