diff --git a/website/source/docs/jobspec/index.html.md b/website/source/docs/jobspec/index.html.md
index 0a74caf9f..1382c4f26 100644
--- a/website/source/docs/jobspec/index.html.md
+++ b/website/source/docs/jobspec/index.html.md
@@ -471,6 +471,35 @@ artifact {
 }
 ```
 
+#### S3 examples
+
+S3 has several different types of addressing and more detail can be found
+[here](http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro)
+
+S3 region specific endpoints can be found
+[here](http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region)
+
+Path based style:
+```
+artifact {
+  source = "https://s3-us-west-2.amazonaws.com/my-bucket-example/my_app.tar.gz"
+}
+```
+
+or to override automatic detection in the url, use the s3 specific syntax
+```
+artifact {
+  source = "s3::https://s3-eu-west-1.amazonaws.com/my-bucket-example/my_app.tar.gz"
+}
+```
+
+Virtual hosted based style
+```
+artifact {
+  source = "my-bucket-example.s3-eu-west-1.amazonaws.com/my_app.tar.gz"
+}
+```
+
 ## JSON Syntax
 
 Job files can also be specified in JSON. The conversion is straightforward