diff --git a/doc/classes/Button.xml b/doc/classes/Button.xml
index ac2b77f40eb..ede9c387c92 100644
--- a/doc/classes/Button.xml
+++ b/doc/classes/Button.xml
@@ -5,6 +5,18 @@
 	</brief_description>
 	<description>
 		Button is the standard themed button. It can contain text and an icon, and will display them according to the current [Theme].
+		[b]Example of creating a button and assigning an action when pressed by code:[/b]
+		[codeblock]
+		func _ready():
+		    var button = Button.new()
+		    button.text = "Click me"
+		    button.connect("pressed", self, "_button_pressed")
+		    add_child(button)
+
+		func _button_pressed():
+		    print("Hello world!")
+		[/codeblock]
+		Buttons (like all Control nodes) can also be created in the editor, but some situations may require creating them from code.
 	</description>
 	<tutorials>
 	</tutorials>