How can I customize the URL of the logo?

[greyscaled]

👋🏻 , Hi everyone - I'm wondering if there's maybe a configuration option I've missed or an otherwise straight forward way to customize the top-left logo URL.

My docs site is a subdomain of our landing page (ex: docs.domain.com), and I'd like for the navigation to go back to the site (ex: domain.com).

Apologies if I missed something obvious - I did some searching in the issue tracker, the configuration options and Jekyll, but nothing popped out to me.

[mattxwang]

Hi @greyscaled, thank you for posting a discussion!

I'm realizing after a quick search that this isn't documented well, but we have a title include that renders the site logo. Unfortunately, this doesn't let you change the URL itself - just what gets rendered. The URL is instead rendered in the sidebar, which is a bit more complicated. So, in other words, there isn't a config option that lets you achieve this.

What you could do is make your own _includes/component/sidebar.html, copy over what's currently in our theme, and then change line 14 to have the URL for your main site. This is not explicitly supported by our theme, because you'd need to keep your sidebar "in sync" with ours (e.g. we may change how the sidebar works with other components - the next time you upgrade your theme, it might break). Since your change is pretty small, I'm not too worried about this - you could just copy over the theme's sidebar when you upgrade, and then remember to change that one line.

Let me know if that makes sense! Separately, this has added another item to my backlog - fixing some of how the title.html include is documented. Thanks!

[greyscaled]

Hey @mattxwang , just wanted to say thanks and send praise for a really helpful answer.

Cheers!