diff --git a/pages/common/poetry-sync.md b/pages/common/poetry-sync.md
new file mode 100644
index 0000000000..dbf71f1305
--- /dev/null
+++ b/pages/common/poetry-sync.md
@@ -0,0 +1,36 @@
+# poetry sync
+
+> Syncs your project's environment with the `poetry.lock` file.
+> More information: <https://python-poetry.org/docs/cli/#sync>.
+
+- Sync your project’s environment with the `poetry.lock` file:
+
+`poetry sync`
+
+- Exclude one or more dependency groups for the installation:
+
+`poetry sync --without {{test|docs|...}}`
+
+- Select optional dependency groups:
+
+`poetry sync --with {{test|docs|...}}`
+
+- Install all dependency groups including optional groups:
+
+`poetry sync --all-groups`
+
+- Install specific dependency groups:
+
+`poetry sync --only {{test|docs|...}}`
+
+- Install project without dependencies:
+
+`poetry sync --only-root`
+
+- Specify extras to install:
+
+`poetry sync {{[-E|--extras]}}`
+
+- Skip the defaulted package installation for your project:
+
+`poetry sync --no-root`