Add logo to repository

[fabiobeoni]

Hello,

anyone knows if there is a way to add a logo to a repository?

I’m experiencing a strange “social” sharing: someone on LinkedIn shares one of my repos, and the sharing message linking the repo shows my github profile picture… sounds strange, it would be better to have there a logo related to the project.

Thanks! F.

[mpboom]

I don’t blieve that is possible.

[DimitriPapadopoulos]

While it is possible to add a logo to a GitHub profile, as far as I know one cannot add a logo to a repository - except by adding an image to the README file. The question was about repositories.

[elmar-chen]

Is there anyway to propose a feature request to github for this?

[mpboom]

Yes. GitHub Support.

[prahladyeri]

Interestingly, this page tops the search result for github repo logo which explains the intensity of this problem! I’m also facing the same issue as you, if I post a link to my github repo, my profilie picture appears as the featured image which is irrelevant and pointless.

This should be trivial to implement. For example, you can take a file like logo.png or favicon.png from the repo’s root directory and make it as the featured image, isn’t it? Gitlab does the same to the best of my knowledge.

Hoping this will be resolved soon my Github support!

[mpboom]

Hi @prahladyeri ,

This issue already has been resolved! See the solution below. This is also interesting for the other contributors to this conversation: @fabiobeoni , @dimitripapadopoulos , @fatemehshirazi .

You can navigate to your repo >  Settings  >  Options > and add an image under  Social media preview. Good luck!

[ahmedmansoor]

Actually, now it's Settings > Social preview.
source: Customizing your repository's social media preview

[janpfeifer]

This would be great if it worked ... I changed the image under Settings > Social preview, and it still displays my profile picture for the repository. Any ideas ?

https://github.com/janpfeifer/gonb

Thanks!

[mpboom]

@janpfeifer probably just a patience will go a long way. Since Google probably already indexed the "old" profile picture image, it'll take a while for it to disappear. Same goes for any messaging/social platforms that already discovered the old thumbnail.

[erickveil]

I think we all have a miscommunication here.

@janpfeifer is expecting the icon for the repository here on github to change, I think. Behavior you would see on, for example, GitLabs.
But the solution here is just for creating a sort of "social media preview" image. You're only going to see it if you, say, post a link to your repository on Reddit or Xitter.

I don't know of a way to change the icon that appears for a specific repository.

[DimitriPapadopoulos]

Ah indeed, this is documented in Customizing your repository’s social media preview.

I have added a logo to one of my repositories. I’m not much in social networks. When I send an SMS with a link to the repository, no preview of any kind appears on Android. Is this very specific to some social networks? Where can I find documentation on the social media preview specification, if there is one?

[mpboom]

Great that you posted a link to the help article! I don’t believe there is more specific information availible. I thinks GitHub makes use of http://ogp.me/ , which transfers this kind of info trough HTML  meta tags.

It is an open protocol and as far as I know it’s supported on most social media and messaging services.

As in your case, I just think your Android SMS application doesn’t allow for previews at all. If it were to allow any preview at all, it would show your profile picture as an image  until you uploaded a custom image. So if you aren’t seeing any image, I don’t think your client supports it.

[prahladyeri]

Thanks, that’s helpful!

[Shailaja-Gupta]

Hi I followed all steps and added logo to reporsitory. However still when I put my repository link on linkedin, I am getting no image. The image is reflecting though on my Settings>Options>Social preview. What to do? I am using laptop to view

[prahladyeri]

Does it show up on twitter cards preview? Here is the test link for twitter cards preview, if it shows up here then there is no need to worry as it could be Linkedin’s caching problem, it’ll be sorted after some time when linkedin knows that your site’s logo is updated.

https://cards-dev.twitter.com/validator

[anmolter]

Hi,
when I put the link to my repository into the card validator, it shows the social media image that I have added. However, when I type the link to my repository into a tweet, it shows my profile image. Is there a specific method that I need to use to link to my repository via Twitter?

[MaximilianKohler]

For the Twitter validator I’m getting:

Unable to render Card preview
Log
ERROR: Fetching the page failed because it's denied by robots.txt.

And Facebook is still showing my profile picture.

LinkedIn post inspector https://www.linkedin.com/post-inspector/inspect is showing it correctly.

EDIT: I got the Facebook preview to work via https://developers.facebook.com/tools/debug/ - “scrape again”. Even though the debug tool said it had been scraped recently already.

[EdoardoCocconi]

maybe try to make a new link to your repo with tinyurl. Linkedin has probably saved your old pic already

[EdoardoCocconi]

Actually tinyurl didn’t work fro me and the picture got back to my profile picture. If you don’t want to wait you can change the name of the repos so you don’t have to wait for linkedin to catch up

[leoheck]

I found this thread, having the same/similar idea.

My idea is that the repo could have a logo. if there is no place to show this logo, it could be used instead of the owner logo when referencing the repo.

[ris58h]

Why Social Preview has to be rectangular? Most logos are square.

[mpboom]

Square logos will get cropped automatically; by being able to upload a rectangular logo you are sure to support all platforms (also the ones that offer rectangular logos), and not just platforms that display square logos.

[ris58h]

You could swap words square and rectangular in your statement and the result would be the same - some platforms support it but some not.

Logos shouldn't be cropped in the first place and most projects already have square logos.

[mpboom]

No, you can not ‘swap words’. A rectangular logo contains more information than a square one. You can cut off part of a rectangular logo to make it square, but not the other way around. Note that GitHub isn’t doing the cropping; the individual implementations of the preview are. GitHub provides the full inage to clients, who then may or may not crop the rectangular logo into a square one.

[mpboom]

But yeah, if your project has a square logo, and you’re set on using that, I’d recommend just applying a background to it with an even color.

[thadguidry]

Adding Images or SVG's to Profiles or README's can now be done with the <picture> element as explained in GitHub Official Docs
https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github

[thadguidry]

There's a few things that GitHub could do that can improve things overall:

1. Allow uploading not only the existing Social Media card in Settings, but also allowing upload of a Logo which would populate the HTML header with og:image as well as Schema.org/image with below.
2. alternatively/additionally adding a bit of JSON-LD with schema.org/SoftwareSourceCode and using its image property.
   • Incidentally, all repo's already have microdata applied with:
     <div itemscope itemtype="http://schema.org/SoftwareSourceCode" class>
     but many Schema.org properties are not utilized such as:
     image, about, description, license, maintainer, discussionUrl, contributor, programmingLanguage, codeRepository, sourceOrganization, etc.
   • It would be best to utilize a JSON-LD script and populate it with relevant Schema.org properties and remove the microdata old ways.

As one of the contributors to Schema.org, I'd be willing to help GitHub and discuss the small improvements necessary, for FREE.

[Jay-Karia]

How can we change the repo icon

To something like this

[bo1ta]

How can we change the repo icon

To something like this

I think that's just for organizations

[Rudra-G-23]

Can we do this?
for the repo?

[dskvr]

Why are people talking about "Social Media Preview" the question clearly asks "Add logo to Repository"

<- how do we change the LOGO, I know it can be changed, but how.

[reactsaas]

yeah social preview to upload image only available in public repo ;(

[AldeRoberge]

To anyone coming later, don't be bothered. GitHub doesn’t allow custom icons. They’ll always use your personal profile picture instead.

There’s no setting, API, or workaround to override that behavior right now. Even if you upload an image in .github/, make a logo in the README, or use GitHub Pages, the actual repo icon shown on your profile or search results will still default to your profile avatar.

[andreasmolnardev]

Apparently they have to keep making GitHub worse instead of actually adding features that.. would make sense

[AldeRoberge]

Apparently they have to keep making GitHub worse instead of actually adding features that.. would make sense

Honestly, they could probably just ask GitHub Copilot to do it, and it would be done in a few minutes. I hope AI helps accelerate these kinds of quality-of-life features. Things that may not directly increase revenue but significantly improve the user experience.