How do I add the Trending Questions block to a Hugo site?

Add a "block: trending-questions" entry to the sections list in your page's front matter, then fill in the content fields. HugoBlox renders it automatically — copy the example config above as a starting point.

Is the Trending Questions block free to use?

Yes. Every HugoBlox block is free and open-source under the MIT license — use it in personal and commercial projects, with no attribution required.

Can I customize the Trending Questions block?

Yes. It exposes 16 content options, and inherits the shared block settings for background, spacing, and colors. You can also describe the changes you want to Hugo Chat AI and it will edit the config for you.

Does the Trending Questions block work with any Hugo theme?

The block ships in the open-source HugoBlox kit. Add the kit to any Hugo site and the block becomes available in your page sections — there is no theme lock-in.

hugoblox.com/blocks/trending-questions

Knowledge baseFree · MITHugo

Trending Questions block

Surface the questions people actually ask — popular, trending, or hand-picked — atop your help center.

Customize with AI View source

Add it to any Hugo page's sections list — no build step.

v1Version

16Options

MITLicense

Quick start

Add the Trending Questions block

Drop this into your page's front matter, under the sections list. Edit the values, and HugoBlox renders the block — no build step.

Add to your page's sections

- block: trending-questions
  design:
    spacing:
      padding:
        - 3rem
        - "0"
        - 3rem
        - "0"
  content:
    title: Trending questions
    subtitle: Top searches from the last 7 days.
    count: 4
    questions:
      - question: How do I deploy Hugo Blox to Netlify?
        answer_preview: Use the provided CI workflow or run `hugo --gc --minify`...
        link: /docs/deploy/netlify/
        badge:
          text: 🔥 Popular
          color: bg-amber-100 text-amber-800
        views: 1200
        upvotes: 86
      - question: Where can I customize Tailwind 4 tokens?
        answer_preview: Tokens are defined in `modules/blox-tailwind/assets/`...
        link: /docs/style/tokens/
        author: geo
    view_all:
      text: Browse all questions
      link: /faq/

Reference

Configuration

Every option the Trending Questions block accepts, generated from its schema.

Content options

Properties set under the block's content key.

Property	Type	Default	Description
`title`	`string`	—	Engagement heading, under 4 words. E.g. 'Trending questions', 'Hot topics'.
`subtitle`	`string`	—	Contextual subtitle, under 8 words. E.g. 'Top searches from the last 7 days.'
`count`	`integer`	4	Number of items to pull when auto-querying pages with `trending: true`
`questions`	`object[]`	—	Static fallback list of questions to render
`questions[].question`required	`string`	—	Natural user question, under 12 words. Start with 'How', 'What', 'Where'.
`questions[].answer_preview`	`string`	—	1-sentence answer teaser, under 15 words. End with '...'
`questions[].link`required	`string`	—	URL to the full answer/article
`questions[].badge`	`object`	—	—
`questions[].badge.text`	`string`	—	—
`questions[].badge.color`	`string`	—	Tailwind classes applied to the badge
`questions[].author`	`string`	—	—
`questions[].views`	`string \| number`	—	—
`questions[].upvotes`	`integer \| number`	—	—
`view_all`	`object`	—	—
`view_all.text`required	`string`	—	—
`view_all.link`required	`string`	—	—