diff --git a/README.rst b/README.rst
index b1cce64af..db34ff487 100644
--- a/README.rst
+++ b/README.rst
@@ -61,9 +61,23 @@ with built-in support for
 Examples
 --------
 
-.. raw:: html
+.. image:: https://user-images.githubusercontent.com/6897215/38739170-6ac7c014-3f34-11e8-9e8f-93b3a3a3d61b.gif
+   :height: 593px
+   :width: 292px
+   :scale: 80%
+
+
+.. image:: https://user-images.githubusercontent.com/6897215/35219611-ac8b2122-ff73-11e7-9332-adffab64a8ce.gif
+   :height: 673px
+   :width: 607px
+   :scale: 50%
+
+
+.. image:: https://user-images.githubusercontent.com/6897215/47256441-d6d53700-d480-11e8-8224-d1cc49dbdcf5.gif
+   :height: 208px
+   :width: 248px
+   :scale: 90%
 
-  <img src="https://user-images.githubusercontent.com/6897215/38739170-6ac7c014-3f34-11e8-9e8f-93b3a3a3d61b.gif" width='20%'> </img> <img src="https://user-images.githubusercontent.com/6897215/35219611-ac8b2122-ff73-11e7-9332-adffab64a8ce.gif" width='40%'> </img> <img src="https://user-images.githubusercontent.com/6897215/47256441-d6d53700-d480-11e8-8224-d1cc49dbdcf5.gif" width='20%'> </img>
 
 .. not-in-documentation-end
 
diff --git a/setup.py b/setup.py
index ffe490361..5016d172e 100644
--- a/setup.py
+++ b/setup.py
@@ -23,6 +23,8 @@ def get_version_and_cmdclass(package_name):
 
 version, cmdclass = get_version_and_cmdclass("adaptive")
 
+with open("README.rst") as f:
+    readme = f.read()
 
 install_requires = [
     "scipy",
@@ -48,6 +50,8 @@ def get_version_and_cmdclass(package_name):
 setup(
     name="adaptive",
     description="Adaptive parallel sampling of mathematical functions",
+    long_description=readme,
+    long_description_content_type="text/x-rst",
     version=version,
     python_requires=">=3.6",
     url="https://adaptive.readthedocs.io/",
@@ -59,6 +63,7 @@ def get_version_and_cmdclass(package_name):
         "Intended Audience :: Science/Research",
         "Programming Language :: Python :: 3.6",
         "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
     ],
     packages=find_packages("."),
     install_requires=install_requires,