custom_head partial not rendering in Docsy v0.11.0 (Hugo module)

[azzaea]

Hi all,

I'm using Docsy as a Hugo module, in a public site:

• https://daic.tudelft.nl/
• Docsy version: v0.11.0 (via Hugo module)
• Hugo version: v0.134.3-extended

I'm trying to embed a Gurubase widget using custom-head.html like so:

$ cat layouts/partials/custom-head.html:

<script async src="https://widget.gurubase.io/widget.latest.min.js" 
    data-widget-id="daHYtXHdDXuG9kL3bddrWFB7ZLmUXNyfdgC_fSDIajo"
    data-text="Ask AI"
    data-margins='{"bottom": "1rem", "right": "1rem"}'
    data-light-mode="auto"
    id="guru-widget-id">
</script>

$ cat config.toml:

[params.ui]
  custom_head = ["custom-head.html"]

Despite this setup:

• The custom-head.html partial is never rendered
• I’ve confirmed this by inserting a <script>console.log()</script> line, then restarted Hugo using hugo server --disableFastRender
• I’ve also tried forcing the widget into head.html (here)[https://github.com/DAIC-tud/docs/blob/main/layouts/partials/head.html#L47], which also does not work.

Is there a known issue with params.ui.custom_head not working in recent module-based setups?
Or, is there a recommended alternative to safely inject third-party widget scripts?

Thanks in advance for any help!

[fekete-robert]

Hi, unless I'm missing something, the docsy base templates do not reference the custom-head.html file, by default, so unless you've added some additional customization they'll just ignore it. But the default templates do provide a hook to include custom stuff at the end of the head section, just create the layouts/partials/hooks/head-end.html file in your project repo and add your script here.

[azzaea]

Thank you! This actually solved it