diff --git a/doc/users.md b/doc/users.md
new file mode 100644
index 0000000000..39f926d7be
--- /dev/null
+++ b/doc/users.md
@@ -0,0 +1,42 @@
+# Notable Projects Using Shields
+
+- https://github.com/AFNetworking/AFNetworking
+- https://github.com/angular/angular.js
+- https://github.com/ansible/ansible
+- https://github.com/apple/swift
+- https://github.com/atom/atom
+- https://github.com/babel/babel
+- https://github.com/chartjs/Chart.js
+- https://github.com/creationix/nvm
+- https://github.com/discourse/discourse
+- https://github.com/docker/docker
+- https://github.com/electron/electron
+- https://github.com/elm-lang/core
+- https://github.com/expressjs/express
+- https://github.com/facebook/react
+- https://github.com/FortAwesome/Font-Awesome
+- https://github.com/gitlabhq/gitlabhq
+- https://github.com/gulpjs/gulp
+- https://github.com/h5bp/html5-boilerplate
+- https://github.com/jakubroztocil/httpie
+- https://github.com/jekyll/jekyll
+- https://github.com/kennethreitz/requests
+- https://github.com/kubernetes/kubernetes
+- https://github.com/laravel/laravel
+- https://github.com/Microsoft/TypeScript
+- https://github.com/Microsoft/vscode
+- https://github.com/Modernizr/Modernizr
+- https://github.com/moment/moment
+- https://github.com/mrdoob/three.js
+- https://github.com/necolas/normalize.css
+- https://github.com/rails/rails
+- https://github.com/reactjs/redux
+- https://github.com/socketio/socket.io
+- https://github.com/tensorflow/tensorflow
+- https://github.com/TryGhost/Ghost
+- https://github.com/twbs/bootstrap
+- https://github.com/vuejs/vue
+- https://github.com/webpack/webpack
+- https://github.com/yarnpkg/yarn
+- https://github.com/zurb/foundation-sites
+- https://libraries.io/github/nodejs/node