diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ef8e6ab
--- /dev/null
+++ b/README.md
@@ -0,0 +1,57 @@
+CONTENTS OF THIS FILE
+---------------------
+* Introduction
+* Requirements
+* Recommended modules
+* Installation
+* Configuration
+* Troubleshooting
+* Contributing
+* Maintainers
+
+
+INTRODUCTION
+------------
+
+This module allows you to create Hubspot form blocks on your Drupal sites.
+
+This module comes with a new field type so each entity can have it's own unique form.
+
+The provided CKEditor plugin allows editors to easily embed a Hubspot Form into content by adding the token:
+```
+[hubspot-form:FORM_ID partner_id:PARTNER_ID]
+```
+
+
+REQUIREMENTS
+------------
+* Core block module
+* Core field module
+
+
+INSTALLATION
+------------
+* Enable module
+* Enter Hubspot API key at Administration >> Configuration >> Web Services >> Hubspot Forms
+  * If you need to generate an API key at Hubspot visit https://app.hubspot.com/keys/get
+
+
+CONFIGURATION
+-------------
+* Visit Administration >> Structure >> Block
+* Click 'Place block' give your block a name and then select the appropriate form from the provided dropdown.
+
+
+TROUBLESHOOTING
+---------------
+* Clear Drupal cache after adding or changing a Hubspot key
+
+
+CONTRIBUTING
+------------
+* Create an issue and attach a patch.
+* Master branch is default for new contributions.
+
+MAINTAINERS
+-----------
+* Minnur Yunusov https://www.drupal.org/u/minnur