Last release 7 months ago
27 Jan 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 7 of 7 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
41 releases · first in 2023
Release timeline
41 releases since 20232023202420252026
20232026
One column per month.
Releases
- v2.5.1-0.20260127154336-52aa5c6dc1d227 Jan 2026pre-release
Nothing published for this version
- v2.5.1-0.20260127154234-41eafd1297d527 Jan 2026pre-release
Nothing published for this version
- v2.5.1-0.20260112174959-cd52f897d66112 Jan 2026pre-release
Nothing published for this version
- v2.5.012 Jan 2026
Release notes
Open source →What's Changed
- Print qualified type name when ErrorUnused=true causes errors for unused keys in embedded fields by @jmacd in #113
- build(deps): bump github/codeql-action from 3.29.2 to 3.29.5 by @dependabot[bot] in #126
- build(deps): bump github/codeql-action from 3.29.7 to 3.29.10 by @dependabot[bot] in #131
- build(deps): bump actions/checkout from 4.2.2 to 5.0.0 by @dependabot[bot] in #129
- feat: support for automatically initializing squashed pointer structs by @tuunit in #71
- build(deps): bump actions/setup-go from 5.5.0 to 6.0.0 by @dependabot[bot] in #134
- build(deps): bump ossf/scorecard-action from 2.4.2 to 2.4.3 by @dependabot[bot] in #142
- Fix slice deep map (owned) by @jphastings in #144
- chore: fix lint violations by @sagikazarmark in #157
- chore: switch to devenv by @sagikazarmark in #158
- build(deps): bump actions/upload-artifact from 4.6.2 to 5.0.0 by @dependabot[bot] in #151
- build(deps): bump github/codeql-action from 3.29.10 to 4.31.2 by @dependabot[bot] in #153
- build(deps): bump golangci/golangci-lint-action from 8.0.0 to 9.0.0 by @dependabot[bot] in #154
- build(deps): bump actions/checkout from 5.0.0 to 6.0.1 by @dependabot[bot] in #160
- build(deps): bump actions/setup-go from 6.0.0 to 6.1.0 by @dependabot[bot] in #159
- build(deps): bump github/codeql-action from 4.31.7 to 4.31.8 by @dependabot[bot] in #162
- build(deps): bump actions/upload-artifact from 5.0.0 to 6.0.0 by @dependabot[bot] in #161
- build(deps): bump github/codeql-action from 4.31.8 to 4.31.9 by @dependabot[bot] in #163
- feature: Add map field name to convert structs dynamically instead of individually with a tag. by @thespags in #149
- feat(decoder): support multiple tag names in order by @DarkiT in #59
- feat: optional root object name by @andreev-fn in #137
- Add unmarshaler interface by @sagikazarmark in #166
New Contributors
- @jmacd made their first contribution in #113
- @tuunit made their first contribution in #71
- @jphastings made their first contribution in #144
- @thespags made their first contribution in #149
- @DarkiT made their first contribution in #59
- @andreev-fn made their first contribution in #137
Full Changelog: v2.4.0...v2.5.0
- v2.4.1-0.20251217034126-6ffa40ae913617 Dec 2025pre-release
Nothing published for this version
- v2.4.1-0.20251213031937-cf810d94344013 Dec 2025pre-release
Nothing published for this version
- v2.4.1-0.20251209172413-af2cf2a8a32d9 Dec 2025pre-release
Nothing published for this version
- v2.4.1-0.20251013204233-b54ec8245e5413 Oct 2025pre-release
Nothing published for this version
- v2.4.1-0.20250820154410-f9d9e58287f220 Aug 2025pre-release
Nothing published for this version
- v2.4.1-0.20250807142409-bbfe61d1af957 Aug 2025pre-release
Nothing published for this version
- v2.4.015 Jul 2025
Release notes
Open source →What's Changed
- refactor: replace interface{} with any by @sagikazarmark in #115
- build(deps): bump github/codeql-action from 3.29.0 to 3.29.2 by @dependabot[bot] in #114
- Generic tests by @sagikazarmark in #118
- Fix godoc reference link in README.md by @peczenyj in #107
- feat: add StringToTimeLocationHookFunc to convert strings to *time.Location by @ErfanMomeniii in #117
- feat: add back previous StringToSlice as a weak function by @sagikazarmark in #119
New Contributors
- @ErfanMomeniii made their first contribution in #117
Full Changelog: v2.3.0...v2.4.0
- v2.3.1-0.20250714172930-9a861bc115f214 Jul 2025pre-release
Nothing published for this version
- v2.3.1-0.20250712081825-de5deae90d8412 Jul 2025pre-release
Nothing published for this version
- v2.3.1-0.20250712055023-742921c9ba2812 Jul 2025pre-release
Nothing published for this version
- v2.3.016 Jun 2025
Release notes
Open source →What's Changed
- build(deps): bump actions/checkout from 4.1.7 to 4.2.0 by @dependabot in #46
- build(deps): bump golangci/golangci-lint-action from 6.1.0 to 6.1.1 by @dependabot in #47
- [enhancement] Add check for
reflect.ValueinComposeDecodeHookFuncby @mahadzaryab1 in #52 - build(deps): bump actions/setup-go from 5.0.2 to 5.1.0 by @dependabot in #51
- build(deps): bump actions/checkout from 4.2.0 to 4.2.2 by @dependabot in #50
- build(deps): bump actions/setup-go from 5.1.0 to 5.2.0 by @dependabot in #55
- build(deps): bump actions/setup-go from 5.2.0 to 5.3.0 by @dependabot in #58
- ci: add Go 1.24 to the test matrix by @sagikazarmark in #74
- build(deps): bump golangci/golangci-lint-action from 6.1.1 to 6.5.0 by @dependabot in #72
- build(deps): bump golangci/golangci-lint-action from 6.5.0 to 6.5.1 by @dependabot in #76
- build(deps): bump actions/setup-go from 5.3.0 to 5.4.0 by @dependabot in #78
- feat: add decode hook for netip.Prefix by @tklauser in #85
- Updates by @sagikazarmark in #86
- build(deps): bump github/codeql-action from 2.13.4 to 3.28.15 by @dependabot in #87
- build(deps): bump actions/setup-go from 5.4.0 to 5.5.0 by @dependabot in #93
- build(deps): bump github/codeql-action from 3.28.15 to 3.28.17 by @dependabot in #92
- build(deps): bump github/codeql-action from 3.28.17 to 3.28.19 by @dependabot in #97
- build(deps): bump ossf/scorecard-action from 2.4.1 to 2.4.2 by @dependabot in #96
- Update README.md by @peczenyj in #90
- Add omitzero tag. by @Crystalix007 in #98
- Use error structs instead of duplicated strings by @m1k1o in #102
- build(deps): bump github/codeql-action from 3.28.19 to 3.29.0 by @dependabot in #101
- feat: add common error interface by @sagikazarmark in #105
- update linter by @sagikazarmark in #106
- Feature allow unset pointer by @rostislaved in #80
New Contributors
- @tklauser made their first contribution in #85
- @peczenyj made their first contribution in #90
- @Crystalix007 made their first contribution in #98
- @rostislaved made their first contribution in #80
Full Changelog: v2.2.1...v2.3.0
- v2.2.2-0.20250616141124-8c61ec1924fc16 Jun 2025pre-release
Nothing published for this version
- v2.2.2-0.20250616133344-ed3f9218152816 Jun 2025pre-release
Nothing published for this version
- v2.2.2-0.20250606113443-1a66224d5e546 Jun 2025pre-release
Nothing published for this version
- v2.2.2-0.20250510134510-396544120c0d10 May 2025pre-release
Nothing published for this version
- v2.2.2-0.20250419225903-232c7c6d592e19 Apr 2025pre-release
Nothing published for this version
- v2.2.2-0.20250417123055-ef196921ef2417 Apr 2025pre-release
Nothing published for this version
- v2.2.2-0.20250326061814-8cfa81661a5926 Mar 2025pre-release
Nothing published for this version
- v2.2.2-0.20250315140719-1072f346635a15 Mar 2025pre-release
Nothing published for this version
- v2.2.2-0.20250218145611-71e356cd8b5f18 Feb 2025pre-release
Nothing published for this version
- v2.2.2-0.20250109111121-7aa50a4e78df9 Jan 2025pre-release
Nothing published for this version
- v2.2.2-0.20241118124956-8101c0bc353418 Nov 2024pre-release
Nothing published for this version
- v2.2.2-0.20241006081944-0b972d9949e76 Oct 2024pre-release
Nothing published for this version
- v2.2.122 Sept 2024
Release notes
Open source →What's Changed
- Pass appropriate empty Value to hooks by @yurishkuro in #45
New Contributors
- @yurishkuro made their first contribution in #45
Full Changelog: v2.2.0...v2.2.1
- v2.2.020 Sept 2024
Release notes
Open source →What's Changed
- feat(decoder-configs): add flag to force decoding nil input in decoder config by @mahadzaryab1 in #42
- Add decode hooks for *url.URL by @EinzigartigerName in #41
New Contributors
- @mahadzaryab1 made their first contribution in #42
- @EinzigartigerName made their first contribution in #41
Full Changelog: v2.1.0...v2.2.0
- v2.1.012 Aug 2024
Release notes
Open source →What's Changed
- build(deps): bump actions/setup-go from 5.0.0 to 5.0.1 by @dependabot in #28
- build(deps): bump actions/checkout from 4.1.1 to 4.1.6 by @dependabot in #27
- build(deps): bump golangci/golangci-lint-action from 3.7.0 to 6.0.1 by @dependabot in #26
- build(deps): bump actions/setup-go from 5.0.1 to 5.0.2 by @dependabot in #34
- build(deps): bump actions/checkout from 4.1.6 to 4.1.7 by @dependabot in #29
- Port Succo's fix to cache decodeHooks by @cedric-cordenier in #33
- build(deps): bump golangci/golangci-lint-action from 6.0.1 to 6.1.0 by @dependabot in #38
- Add configuration option to specify tag value that indicates squash by @triarius in #18
- Adding support for squash: interface. by @m1k1o in #17
New Contributors
- @dependabot made their first contribution in #28
- @cedric-cordenier made their first contribution in #33
- @triarius made their first contribution in #18
- @m1k1o made their first contribution in #17
Full Changelog: v2.0.0...v2.1.0
- v2.0.1-0.20240811220347-2842dc86cbc811 Aug 2024pre-release
Nothing published for this version
- v2.0.1-0.20240805221037-cafeac4f35565 Aug 2024pre-release
Nothing published for this version
- v2.0.1-0.20240720132425-fd1be46fa74d20 Jul 2024pre-release
Nothing published for this version
- v2.0.1-0.20240602085007-0382e5b7e3982 Jun 2024pre-release
Nothing published for this version
- v2.0.02 Jun 2024
Release notes
Open source →mapstructure v2 release 🎉🎉🎉🎉
⚠️ Breaking changes
Erroris removed in favor oferrors.Join(backported from Go 1.20 to preserve compatibility with earlier versions)
What's Changed
- feat!: update module path by @sagikazarmark in #9
- build: update dev env by @sagikazarmark in #14
- feature: add StringToBasicTypeHookFunc and support complex by @tlipoca9 in #13
- Add an example showing how to use a DecodeHookFunc to parse a custom … by @carlohamalainen in #10
- Remove exposed error type by @sagikazarmark in #24
- Replace internal joined error with errors.Join by @sagikazarmark in #25
- Prepare release by @sagikazarmark in #23
New Contributors
- @tlipoca9 made their first contribution in #13
- @carlohamalainen made their first contribution in #10
Full Changelog: v1.6.0...v2.0.0
- v2.0.0-alpha.1.0.20240602075001-57a3d74ac3292 Jun 2024pre-release
Nothing published for this version
- v2.0.0-alpha.1.0.20240227123954-cb699d2a12c627 Feb 2024pre-release
Nothing published for this version
- v2.0.0-alpha.1.0.20240226124921-b71c54176d2b26 Feb 2024pre-release
Nothing published for this version
- v2.0.0-alpha.1.0.20231222143158-7017a6863b5122 Dec 2023pre-release
Nothing published for this version
- v2.0.0-alpha.119 Dec 2023pre-release
Release notes
Open source →First alpha release with the new import path:
github.com/go-viper/mapstructure/v2 - v2.0.0-20231219210202-579c0fe9ed2f19 Dec 2023pre-release
Nothing published for this version