How to change logo in docker hub repository


it seems to be a big secret how to change the logo in a Docker Hub Repository.
I found only very rare information about this. One of them says, that a verified publisher account is required, but in the hub there are several OSS repositories which have also a logo.

Is there an easy way to change it in the docker hub webinterface?

Best regards,

1 Like

OSS repository means that the repository is part of the sponsored open source software program

Do you have an aceppted OSS repository like that?

Yes I have, but I found no possibility to change the repo icon.


I don’t have any OSS repo, so I don’t know exaclty how you could add a logo, but if you check the current logos those are linked from and the logo is not actually a product logo but the profile picture of the owner. Maybe you just need to upload a picture to your email addres on gravatar.

I had this idea either, but came to the conclusion, that the gravatar is only for my Docker ID account, but not for the organization. And furthermore, every repo inside a namespace could have another logo - obviously.
But to be honest, I didn’t try - I will do now.
Thanks a lot.

Yes, but no project has custom logo like that. Official images are different, since there is no owner the same way as other repositories have. When I browse verified publisher images or OSS images I can see only owner level logos.

Hi, I added my gravtar e-mail to the managing account since there is no gravatar e-mail field for the organisation. I still see the blue cube: Docker

I guess it took time the picture to be visible, because it is now.

Hi, Any news on this?? I found reading the internet that we need to define in the description and the logo image that Dockerhub takes from there to put as a logo for the repository, but I don´t know where I need to put that and how to build and image with this inside.

Then you know more than I. Please, share where you read that Docker Hub would read the logo from the readme file.

I have shared what I could about using custom logos in my previous posts. I also found this today:

Verified publishers can override the organization level logo with a repisotiry logo. Otherwise you can have an organization logo.

What you probably meant by the README file is that when you share a repisutory on facebook for example, Facebook could recognize the picture if there is no “og” image in the HTML header. I doubt that would be a logo on Docker Hub.

Changing the logo on Docker Hub isn’t straightforward via the web interface. Though a verified publisher account is suggested, some OSS repositories have logos. Check recent updates or contact Docker Hub support for the latest on logo customization.