diff --git a/README.txt b/README.txt
index f063aec..8e7c5cc 100644
--- a/README.txt
+++ b/README.txt
@@ -17,3 +17,44 @@ At this time, this module only provides a 'plupload' form element type that
 other modules can use for providing multiple file upload capability to their
 forms. It does not provide any end-user functionality on its own. This may
 change, however, as this module evolves. See http://drupal.org/node/880300.
+
+---=== For developers ===---
+
+Plupload from element can be used like this:
+
+$form['my_element'] = array(
+  '#type' => 'plupload',
+  '#title' => t('Upload files'),
+  '#description => t('This multi-upload widget uses Plupload library.'),
+  '#upload_validators' => array(
+    'file_validate_extensions' => array('jpg jpeg gif png txt doc xls pdf ppt pps odt ods odp'),
+    'my_custom_file_validator => array('some validation criteria'),
+  );
+  '#plupload_settings' => array(
+    'runtimes' => 'html5',
+    'chunk_size => '1mb',
+  ),
+);
+
+- #upload_validators - an array of validation function/validation criteria pairs, that
+  will be passed to file_validate().
+  
+  Defaults to:
+  '#upload_validators' => array(
+    'file_validate_extensions' => array('jpg jpeg gif png txt doc xls pdf ppt pps odt ods odp'),
+  );
+  
+  
+- #plupload_settings - array of settings, that will be passed to Plupload library. 
+  See: http://www.plupload.com/documentation.php
+  
+  Defaults to:
+  '#plupload_settings' => array(
+    'runtimes' => 'html5,flash,html4',
+    'url' => url('plupload-handle-uploads', array('query' => array('plupload_token' => drupal_get_token('plupload-handle-uploads')))),
+    'max_file_size' => file_upload_max_size() . 'b',
+    'chunk_size' => '1mb',
+    'unique_names' => TRUE,
+    'flash_swf_url' => file_create_url($library_path . '/js/plupload.flash.swf'),
+    'silverlight_xap_url' => file_create_url($library_path . '/js/plupload.silverlight.xap'),
+  ),
\ No newline at end of file