1 files changed, 26 insertions, 0 deletions

diff --git a/doc/workflow/import_projects_from_bitbucket.md b/doc/workflow/import_projects_from_bitbucket.md
new file mode 100644
index 00000000000..56b5c8d2ffe
--- /dev/null
+++ b/doc/workflow/import_projects_from_bitbucket.md
@@ -0,0 +1,26 @@
+# Import your project from Bitbucket to GitLab
+
+It takes just a few steps to import your existing Bitbucket projects to GitLab. But keep in mind that it is possible only if Bitbucket support is enabled on your GitLab instance. You can read more about Bitbucket support [here](doc/integration/bitbucket.md).
+
+1. Sign in to GitLab.com and go to your dashboard
+2. Click on "New project"
+![New project in GitLab](bitbucket_importer/bitbucket_import_new_project.jpg)
+
+
+
+3. Click on the "Bitbucket" button
+![Bitbucket](bitbucket_importer/bitbucket_import_select_bitbucket.jpg)
+
+
+
+4. Grant GitLab access to your Bitbucket account
+![Grant access](bitbucket_importer/bitbucket_import_grant_access.jpg)
+
+
+
+5. Click on the projects that you'd like to import or "Import all projects"
+![Import projects](bitbucket_importer/bitbucket_import_select_project.png)
+
+
+
+A new GitLab project will be created with your imported data.