diff --git a/README.md b/README.md
index 15f3b43d..8b112745 100644
--- a/README.md
+++ b/README.md
@@ -12,4 +12,4 @@ This package was kindly donated to the [Pydantic organisation](https://github.co
 For the old "Hipster-orgazmic tool to mange application settings" package, see [version 0.2.5](https://pypi.org/project/pydantic-settings/0.2.5/).
 
 
-See [documentation](https://docs.pydantic.dev/latest/usage/pydantic_settings/) for more details.
+See [documentation](https://docs.pydantic.dev/latest/concepts/pydantic_settings/) for more details.
diff --git a/pyproject.toml b/pyproject.toml
index 18591922..2776f921 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -50,7 +50,7 @@ Homepage = 'https://github.com/pydantic/pydantic-settings'
 Funding = 'https://github.com/sponsors/samuelcolvin'
 Source = 'https://github.com/pydantic/pydantic-settings'
 Changelog = 'https://github.com/pydantic/pydantic-settings/releases'
-Documentation = 'https://docs.pydantic.dev/dev-v2/usage/pydantic_settings/'
+Documentation = 'https://docs.pydantic.dev/dev-v2/concepts/pydantic_settings/'
 
 [tool.pytest.ini_options]
 testpaths = 'tests'