diff --git a/docs/routable_page.rst b/docs/routable_page.rst
index e15fd5a83..0b982752d 100644
--- a/docs/routable_page.rst
+++ b/docs/routable_page.rst
@@ -53,9 +53,18 @@ The ``RoutablePage`` class
 .. automodule:: wagtail.contrib.wagtailroutablepage.models
 .. autoclass:: RoutablePage
 
-    .. attribute:: subpage_urls
+    .. autoattribute:: subpage_urls
 
-        Set this to a tuple of ``django.conf.urls.url`` objects.
+        Example:
+
+        .. code-block:: python
+
+            from django.conf.urls import url
+
+            subpage_urls = (
+                url(r'^$', 'serve', name='main'),
+                url(r'^archive/$', 'archive', name='archive'),
+            )
 
     .. automethod:: resolve_subpage
 
diff --git a/wagtail/contrib/wagtailroutablepage/models.py b/wagtail/contrib/wagtailroutablepage/models.py
index c5449b0fd..f853208af 100644
--- a/wagtail/contrib/wagtailroutablepage/models.py
+++ b/wagtail/contrib/wagtailroutablepage/models.py
@@ -12,6 +12,7 @@ class RoutablePage(Page):
     """
     This class extends Page by adding methods to allow urlconfs to be embedded inside pages
     """
+    #: Set this to a tuple of ``django.conf.urls.url`` objects.
     subpage_urls = None
 
     def reverse_subpage(self, name, args=None, kwargs=None):