How to add group name to keymaps in V3?

[6H075T2]

Hello! Like what the title says how can I add group name to a key?

I've already looked answers in the internet but it seems whichkey.register() is already deprecated and :checkhealth which-key command recommends using mapping = {} spec but I don't have any idea how to do so since the which-key docs doesn't provide any example for reference and I don't find any similar issues regarding this.

I'd like to add group name to Telescope plugin keys without making/adding keys at all since the keys are already defined in
Telescope plugin spec with keys = {} for lazyloading.

[karmicdude]

+1 from me.

{ "<leader>t", group = "  Terminal", desc = "  Terminal", nowait = true, remap = false, mode = { "n", "v" } },
...

doesn't display group name, still +n keymaps

[allreddv]

Here is how I did mine while keeping all my bindings I already had set in a bunch of plugin configs but I just wanted to name groups. It works for me. Just first define group for the main keybinding and the you can add subgroups also py just adding the next subgroup to the keybind with a description. So for example, in mine, I have 4 subgroups within my Telescope "page" so now when I hit leader I will see f: Telescope ,on first page, second page has all my keybindings and descriptions already setup before, plus i will see h: Harpoon, etc. for the subgroups. Hope this helps.

		config = function()
			local wk = require("which-key")

			wk.add({
				{ "<leader>m", group = ".md files" },
				{ "<leader>mo", desc = "Obsidian", icon = "" },
				{ "<leader>mp", desc = "Paste URLs", icon = "" },
				{ "<leader>mh", desc = "Create Heading", icon = "" },
				{ "<leader>mi", desc = "Image Paste", icon = "" },
				{ "<leader>mb", desc = "Bullets", icon = "•" },
				{ "<leader>mc", desc = "Callbacks", icon = "" },
				{ "<leader>t", group = "Tabs & Terminal", icon = "" },
				{ "<leader>z", group = "Folds", icon = "" },
				{ "<leader>e", group = "Explorer", icon = "" },
				{ "<leader>f", group = "Telescope", icon = "" },
				{ "<leader>fh", desc = "Harpoon", icon = "" },
				{ "<leader>fs", desc = "Grep", icon = "" },
				{ "<leader>fw", desc = "Tailwind Picker", icon = "" },
				{ "<leader>fc", desc = "CMD Line", icon = "" },
				{ "<leader>g", group = "Git", icon = "" },
				{ "<leader>x", group = "Trouble", icon = "" },
				{ "<leader>p", group = "Panes", icon = "" },
			}, { prefix = "<leader>" })
		end,
		``` 

[karmicdude]

{ "f", group = "Telescope", icon = "" },

Are you sure you are using v3 API? It's not working for me with v3

[whbos]

This works for me. Based on the example snippet shown on the home page:

{
  "folke/which-key.nvim",
  event = "VeryLazy",
  opts = {
    -- your configuration comes here
    -- or leave it empty to use the default settings
    -- refer to the configuration section below
    spec = {
      { "<leader>e", group = "explorer" },
    },
  },
  keys = {
    {
      "<leader>?",
      function()
        require("which-key").show({ global = false })
      end,
      desc = "Buffer Local Keymaps (which-key)",
    },
  },
}