diff --git a/pages/common/kubectl-replace.md b/pages/common/kubectl-replace.md
new file mode 100644
index 000000000..91075ca64
--- /dev/null
+++ b/pages/common/kubectl-replace.md
@@ -0,0 +1,16 @@
+# kubctl replace
+
+> Replace a resource by file or `stdin`.
+> More information: <https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#replace>.
+
+- Replace the resource using the resource definition file:
+
+`kubectl replace -f {{path/to/file.yml}}`
+
+- Replace the resource using the input passed into `stdin`:
+
+`kubectl replace -f -`
+
+- Force replace, delete and then re-create the resource:
+
+`kubectl replace --force -f {{path/to/file.yml}}`