mkdocs-exclude-search (https://github.com/chrieke/mkdocs-exclude-search)
seems promising
We can try something like this to exclude all the versioned paths:
```
plugins:
- search
- exclude-search:
exclude:
- "*/[0-9]*/**"
```
Note that nightly and latest are symlinks.
On Thu, May 14, 2026 at 9:54 AM Kevin Liu <[email protected]> wrote:
> +1 to only indexing the latest/nightly
> mkdoc is using the `search` plugin [1]. And like you mentioned, we can use
> its `exclude ` property to configure exclusion paths.
>
>
> > Is there a way we can add a Version dropdown to the search? "Latests,
> 1.11, etc ...."
>
> I've looked into this before, the best solution I found is to migrate over
> to `mike` (see the tracking issue
> https://github.com/apache/iceberg/issues/14521) It's a lot of work though
> and I didn't want to risk breaking the site.
>
> Best,
> Kevin Liu
>
>
> [1]
> https://github.com/apache/iceberg/blob/87a7e4b13470b238e86872e5b194b80c3a89a80f/site/mkdocs.yml#L51
> [2]
> https://squidfunk.github.io/mkdocs-material/plugins/search/#meta.search.exclude
>
>
>
> On Thu, May 14, 2026 at 9:33 AM Max Konstantinov <
> [email protected]> wrote:
>
>> That was my first idea too. I did some research and it seems it will be
>> more complicated to implement and might require an overhaul of the site
>> build process or/and site structure. Let me look into that again and get
>> back with an overview of potential changes.
>>
>> On Thu, May 14, 2026 at 9:13 AM Russell Spitzer <
>> [email protected]> wrote:
>>
>>> Is there a way we can add a Version dropdown to the search? "Latests,
>>> 1.11, etc ...."
>>>
>>> On Thu, May 14, 2026 at 10:26 AM Max Konstantinov <
>>> [email protected]> wrote:
>>>
>>>> I looked into options for resolving that and the easiest solution I
>>>> found is to exclude all md files from search for all Icerbrg documentation
>>>> versions, except for the just one, nightly probably being the best
>>>> candidate as it is a defult landing version of documentation. That can be
>>>> achieved by adding a mkdocs-material's YAML frontmatter property to md
>>>> files during the site build process:
>>>>
>>>> ---
>>>> <https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#__codelineno-6-2>search:
>>>>
>>>> <https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#__codelineno-6-3>
>>>> exclude: true
>>>> <https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#__codelineno-6-4>---
>>>>
>>>>
>>>>
>>>> On Thu, May 14, 2026 at 1:39 AM Robin Moffatt via dev <
>>>> [email protected]> wrote:
>>>>
>>>>> I agree, the current behaviour is not ideal for the end-user. The
>>>>> results don't indicate the version either so you end up with literal
>>>>> duplicates:
>>>>> [image: CleanShot 2026-05-14 at [email protected]]
>>>>>
>>>>> On Thu, 14 May 2026 at 07:17, Max Konstantinov <
>>>>> [email protected]> wrote:
>>>>>
>>>>>> Hi all,
>>>>>>
>>>>>>
>>>>>> Problem statement
>>>>>> If you open https://iceberg.apache.org/
>>>>>> <https://urldefense.com/v3/__https://iceberg.apache.org/__;!!Ayb5sqE7!oRqHG1ZbjiQCzTf4geY7acwJ5T348ItdBhCxA93gVPFAC7C6I6nQHtkpxvkEN1zEBSfkq7BdqNaJnYBf6wfaUGD1HAZo$>
>>>>>> and
>>>>>> use a search bar to look for anything, ex: "rewrite", you get duplicated
>>>>>> results because results(ex: rewrite_table_path) are found multiple times,
>>>>>> once for each version of Iceberg documentation(1.4 to 1.10), all these
>>>>>> versions are present on the website under the previous section in the
>>>>>> navigation tab and all of them are indexed.
>>>>>>
>>>>>> Question
>>>>>> Is that a bug and does it need to be addressed? I have a suggestion
>>>>>> on how to approach this.
>>>>>>
>>>>>> Notes
>>>>>> Iceberg's site build uses mkdocs and mkdocs-material which in turn
>>>>>> utilize lunrjs for search.
>>>>>>
>>>>>>
>>>>>> Max.
>>>>>>
>>>>>
>>>>>
>>>>>
