Documentation » Admin

11. Overwrite Admin Configuration »

« 9. Creating a Custom Admin Action

This Page

11. Overwrite Admin Configuration »

« 9. Creating a Custom Admin Action

10. Customizing a mosaic list

New in version 3.0: Since 3.0, the AdminBundle includes a mosaic list mode in order to have a more visual representation.

Default view

It is possible to configure the default view by creating a dedicated template.


If you want to change the default mosaic background globally, please use the following configuration:

# config/packages/sonata_admin.yaml

    # ...
        # ...
        mosaic_background: '/path/to/image.png' # or use base64

First, configure the outer_list_rows_mosaic template key:

<!-- config/services.xml -->

 <service id="" class="">
      <call method="setTemplates">
          <argument type="collection">
              <argument key="outer_list_rows_mosaic">@SonataMedia/MediaAdmin/list_outer_rows_mosaic.html.twig</argument>

The list_outer_rows_mosaic.html.twig is the name of one mosaic’s tile. You should also extends the template and overwrite the default blocks availables.

{% extends '@SonataAdmin/CRUD/list_outer_rows_mosaic.html.twig' %}

{% block sonata_mosaic_background %}{{ meta.image }}{% endblock %}

{% block sonata_mosaic_default_view %}
    <span class="label label-primary pull-right">{{ object.providerName|trans({}, 'SonataMediaBundle') }}</span>
{% endblock %}

{% block sonata_mosaic_hover_view %}
    <span class="label label-primary pull-right">{{ object.providerName|trans({}, 'SonataMediaBundle') }}</span>

    {% if object.width %} {{ object.width }}{% if object.height %}x{{ object.height }}{% endif %}px{% endif %}
    {% if object.length > 0 %}
        ({{ object.length }})
    {% endif %}


    {% if object.authorname is not empty %}
       {{ object.authorname }}
    {% endif %}

    {% if object.copyright is not empty and object.authorname is not empty %}
    {% endif %}

    {% if object.copyright is not empty %}
        &copy; {{ object.copyright }}
    {% endif  %}
{% endblock %}

{% block sonata_mosaic_description %}
    {% if admin.hasAccess('edit', object) and admin.hasRoute('edit') %}
        <a href="{{ admin.generateObjectUrl('edit', object) }}">{{ meta.title|u.truncate(40) }}</a>
    {% elseif admin.hasAccess('show', object) and admin.hasRoute('show') %}
        <a href="{{ admin.generateObjectUrl('show', object }) }}">{{ meta.title|u.truncate(40) }}</a>
    {% else %}
        {{ meta.title|u.truncate(40) }}
    {% endif %}
{% endblock %}

10.1. Block types

  • sonata_mosaic_background: this block is the background value defined in the ObjectMetadata object.
  • sonata_mosaic_default_view: this block is used when the list is displayed.
  • sonata_mosaic_hover_view: this block is used when the mouse is over the tile.
  • sonata_mosaic_description: this block will be always on screen and should represent the entity’s name.

The ObjectMetadata object is returned by the related admin class, and can be used to define which image field from the entity will be displayed if available. For instance, the SonataMediaBundle defines the method as:

final class MediaAdmin extends AbstractAdmin
    public function getObjectMetadata($object)
        $provider = $this->pool->getProvider($object->getProviderName());

        $url = $provider->generatePublicUrl($object, $provider->getFormatName($object, 'admin'));

        return new Metadata($object->getName(), $object->getDescription(), $url);


In your own admin, media is a field and not the $object. Therefore, the code above must be updated this way:

public function getObjectMetadata($object): Metadata
    $media = $object->getMediaField();

    $provider = $this->pool->getProvider($media->getProviderName());

    $url = $provider->generatePublicUrl($media, $provider->getFormatName($media, 'admin'));

    return new Metadata($media->getName(), $media->getDescription(), $url);

You will also have to use dependency injection. For this, first define the $pool variable and override the constructor:

use Sonata\MediaBundle\Provider\Pool;

private $pool;

public function __construct(string $code, string $class, string $baseControllerName, Pool $pool)
   $this->pool = $pool;

   parent::__construct($code, $class, $baseControllerName);

Then add '' to your service definition arguments:

# config/services.yaml

        class: App\Admin\PostAdmin
            - ~
            - App\Entity\Post
            - ~
            - ''
                name: sonata.admin
                manager_type: orm
                group: 'Content'
                label: 'Post'

The final view will look like:

Customize view

Found a typo? Something is wrong in this documentation? Just fork and edit it!