diff --git a/src/client/mod.rs b/src/client/mod.rs
index b0193b3b106..94d2c54dbcc 100644
--- a/src/client/mod.rs
+++ b/src/client/mod.rs
@@ -529,6 +529,22 @@ impl Client {
 
     /// Attaches a handler for when a [`MessageCreate`] is received.
     ///
+    /// # Examples
+    ///
+    /// Print the contents of every received message:
+    ///
+    /// ```rust,ignore
+    /// use serenity::Client;
+    ///
+    /// let mut client = Client::login_bot("bot token here");
+    ///
+    /// client.on_message(|_context, message| {
+    ///     println!("{}", message.content);
+    /// });
+    ///
+    /// let _ = client.start();
+    /// ```
+    ///
     /// [`MessageCreate`]: ../model/event/enum.Event.html#variant.MessageCreate
     pub fn on_message<F>(&mut self, handler: F)
         where F: Fn(Context, Message) + Send + Sync + 'static {