diff --git a/MANIFEST.in b/MANIFEST.in
index f1a78ee..0f89fb7 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -4,6 +4,9 @@ graft requirements
 
 include AUTHORS.rst LICENSE*.rst README.rst
 
+# include examples inside the package
+recursive-include docs/examples *
+
 # Exclude all bytecode files and __pycache__ directories
 global-exclude *.py[cod]  # Exclude all .pyc, .pyo, and .pyd files.
 global-exclude .DS_Store  # Exclude Mac filesystem artifacts.
diff --git a/news/ship-examples.rst b/news/ship-examples.rst
new file mode 100644
index 0000000..27fc85d
--- /dev/null
+++ b/news/ship-examples.rst
@@ -0,0 +1,23 @@
+**Added:**
+
+* No news needed.
+
+**Changed:**
+
+* <news item>
+
+**Deprecated:**
+
+* <news item>
+
+**Removed:**
+
+* <news item>
+
+**Fixed:**
+
+* <news item>
+
+**Security:**
+
+* <news item>
diff --git a/pyproject.toml b/pyproject.toml
index 7f46926..e65cd81 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -87,3 +87,9 @@ exclude = '''
   | tests/data
 )/
 '''
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.package-data]
+"diffpy.cmi" = ["../docs/examples/**/*"]