diff --git a/docs/ruby/client.asciidoc b/docs/ruby/client.asciidoc
index 2037ae1a0b280..074c77d41b03b 100644
--- a/docs/ruby/client.asciidoc
+++ b/docs/ruby/client.asciidoc
@@ -1,3 +1,4 @@
+[[ruby_client]]
 == The Ruby Client
 
 The `elasticsearch` http://rubygems.org/gems/elasticsearch[Rubygem] provides a low-level client
diff --git a/docs/ruby/copyright.asciidoc b/docs/ruby/copyright.asciidoc
index 3747cc572e40f..8a84be27636f4 100644
--- a/docs/ruby/copyright.asciidoc
+++ b/docs/ruby/copyright.asciidoc
@@ -1,3 +1,4 @@
+[[copyright]]
 == Copyright and License
 
 This software is Copyright (c) 2013-2018 by Elasticsearch BV.
diff --git a/docs/ruby/model.asciidoc b/docs/ruby/model.asciidoc
index 0b0be45708fa8..62339bb239149 100644
--- a/docs/ruby/model.asciidoc
+++ b/docs/ruby/model.asciidoc
@@ -1,3 +1,4 @@
+[[activemodel_activerecord]]
 == ActiveModel / ActiveRecord
 
 The `elasticsearch-model` http://rubygems.org/gems/elasticsearch-model[Rubygem]
diff --git a/docs/ruby/persistence.asciidoc b/docs/ruby/persistence.asciidoc
index 7d361978ee703..5306dae47c661 100644
--- a/docs/ruby/persistence.asciidoc
+++ b/docs/ruby/persistence.asciidoc
@@ -1,3 +1,4 @@
+[[persistence]]
 == Persistence
 
 The `elasticsearch-persistence` http://rubygems.org/gems/elasticsearch-persistence[Rubygem]
diff --git a/docs/ruby/rails.asciidoc b/docs/ruby/rails.asciidoc
index 1fef3f42381a6..213258c7e2266 100644
--- a/docs/ruby/rails.asciidoc
+++ b/docs/ruby/rails.asciidoc
@@ -1,3 +1,4 @@
+[[ruby_on_rails]]
 == Ruby On Rails
 
 The `elasticsearch-rails` http://rubygems.org/gems/elasticsearch-rails[Rubygem]