diff --git a/README.rst b/README.rst
index 32a9b2c..a9652c1 100644
--- a/README.rst
+++ b/README.rst
@@ -236,6 +236,32 @@
 ``/etc/skel/.bashrc``). This formula will do this automatically, but will not
 touch existing user's ``~/.bashrc`` files except root.
 
+Message of the day
+~~~~~~~~~~~~~~~~~~
+
+``pam_motd`` from package ``update-motd`` is used for dynamic messages of the
+day. Setting custom motd will cleanup existing ones.
+
+.. code-block:: yaml
+
+    linux:
+      system:
+        motd:
+          - release: |
+              #!/bin/sh
+              [ -r /etc/lsb-release ] && . /etc/lsb-release
+
+              if [ -z "$DISTRIB_DESCRIPTION" ] && [ -x /usr/bin/lsb_release ]; then
+              	# Fall back to using the very slow lsb_release utility
+              	DISTRIB_DESCRIPTION=$(lsb_release -s -d)
+              fi
+
+              printf "Welcome to %s (%s %s %s)\n" "$DISTRIB_DESCRIPTION" "$(uname -o)" "$(uname -r)" "$(uname -m)"
+          - warning: |
+              #!/bin/sh
+              printf "This is [company name] network.\n"
+              printf "Unauthorized access strictly prohibited.\n"
+
 Linux network
 -------------