diff --git a/lib/awful/widget/taglist.lua b/lib/awful/widget/taglist.lua
index e2a74415..fe6744e3 100644
--- a/lib/awful/widget/taglist.lua
+++ b/lib/awful/widget/taglist.lua
@@ -411,7 +411,7 @@ end
 --   update. See `awful.widget.common`.
 -- @tparam[opt] widget args.layout Optional layout widget for tag widgets. Default
 --   is wibox.layout.fixed.horizontal().
--- @tparam[opt] table widget_template A custom widget to be used for each tag
+-- @tparam[opt] table args.widget_template A custom widget to be used for each tag
 -- @tparam[opt={}] table args.style The style overrides default theme.
 -- @tparam[opt=nil] string|pattern args.style.fg_focus
 -- @tparam[opt=nil] string|pattern args.style.bg_focus
diff --git a/lib/awful/widget/tasklist.lua b/lib/awful/widget/tasklist.lua
index b8a3cdb5..24951a75 100644
--- a/lib/awful/widget/tasklist.lua
+++ b/lib/awful/widget/tasklist.lua
@@ -430,7 +430,7 @@ end
 --   update. See `awful.widget.common.list_update`.
 -- @tparam[opt] table args.layout Container widget for tag widgets. Default
 --   is `wibox.layout.flex.horizontal`.
--- @tparam[opt] table widget_template A custom widget to be used for each client
+-- @tparam[opt] table args.widget_template A custom widget to be used for each client
 -- @tparam[opt={}] table args.style The style overrides default theme.
 -- @tparam[opt=nil] string|pattern args.style.fg_normal
 -- @tparam[opt=nil] string|pattern args.style.bg_normal