diff --git a/org.eclipse.buildship.ui/plugin.xml b/org.eclipse.buildship.ui/plugin.xml
index 4719cd31e6..fd1fc3cdb0 100644
--- a/org.eclipse.buildship.ui/plugin.xml
+++ b/org.eclipse.buildship.ui/plugin.xml
@@ -51,6 +51,28 @@
             name="Gradle">
       </category>
     </extension>
+    
+    <!-- integration of a Gradle workspace composite creation wizard -->
+    <extension point="org.eclipse.ui.newWizards">
+    	<wizard
+            id="org.eclipse.buildship.ui.wizard.workspaceComposite.creation"
+            class="org.eclipse.buildship.ui.internal.wizard.workspacecomposite.WorkspaceCompositeCreationWizard"
+            category="org.eclipse.buildship.ui.creationwizards"
+            icon="icons/full/etool16/creation_wiz.png"
+            name="Gradle Composite"
+            canFinishEarly="false"
+            hasPages="true"
+            project="true">
+         <description>
+            Create a new Gradle workspace composite.
+         </description>
+         <keywordReference id="org.eclipse.buildship.ui.keyword.buildship"/>
+      </wizard>
+      <category
+            id="org.eclipse.buildship.ui.creationwizards"
+            name="Gradle">
+      </category>
+    </extension>
 
     <!-- definition of keywords available in search fields of Gradle project wizards -->
     <extension
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/preferences/GradleCompositeImportOptionsPreferencePage.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/preferences/GradleCompositeImportOptionsPreferencePage.java
new file mode 100644
index 0000000000..c1e74bbc38
--- /dev/null
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/preferences/GradleCompositeImportOptionsPreferencePage.java
@@ -0,0 +1,135 @@
+/*******************************************************************************
+ * Copyright (c) 2019 Gradle Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ******************************************************************************/
+
+package org.eclipse.buildship.ui.internal.preferences;
+
+import java.io.File;
+
+import org.eclipse.buildship.core.internal.CorePlugin;
+import org.eclipse.buildship.core.internal.configuration.BuildConfiguration;
+import org.eclipse.buildship.core.internal.configuration.ConfigurationManager;
+import org.eclipse.buildship.core.internal.util.binding.Validator;
+import org.eclipse.buildship.core.internal.util.binding.Validators;
+import org.eclipse.buildship.ui.internal.util.gradle.GradleDistributionViewModel;
+import org.eclipse.buildship.ui.internal.util.widget.AdvancedOptionsGroup;
+import org.eclipse.buildship.ui.internal.util.widget.GradleProjectSettingsComposite;
+import org.eclipse.core.resources.IProject;
+import org.eclipse.core.runtime.Platform;
+import org.eclipse.swt.events.SelectionEvent;
+import org.eclipse.swt.events.SelectionListener;
+import org.eclipse.swt.widgets.Composite;
+import org.eclipse.swt.widgets.Control;
+import org.eclipse.ui.dialogs.PreferencesUtil;
+import org.eclipse.ui.dialogs.PropertyPage;
+
+/**
+ * Preference page for composite import options.
+ *
+ * @author Sebastian Kuzniarz
+ */
+public final class GradleCompositeImportOptionsPreferencePage extends PropertyPage {
+
+    public static final String PAGE_ID = "org.eclipse.buildship.ui.compositeImportOptionsProperties";
+
+    private GradleProjectSettingsComposite gradleProjectSettingsComposite;
+
+    private final Validator<GradleDistributionViewModel> distributionValidator;
+    private final Validator<File> javaHomeValidator;
+    private final Validator<File> gradleUserHomeValidator;
+
+    public GradleCompositeImportOptionsPreferencePage() {
+        this.gradleUserHomeValidator = Validators.optionalDirectoryValidator("Gradle user home");
+        this.javaHomeValidator = Validators.optionalDirectoryValidator("Java home");
+        this.distributionValidator = GradleDistributionViewModel.validator();
+    }
+
+    @Override
+    protected Control createContents(Composite parent) {
+        this.gradleProjectSettingsComposite = GradleProjectSettingsComposite.builder(parent)
+                .withAutoSyncCheckbox()
+                .withOverrideCheckbox("Override workspace settings", "Configure Workspace Settings")
+                .build();
+        initValues();
+        addListeners();
+        return this.gradleProjectSettingsComposite;
+    }
+
+    private void initValues() {
+        IProject project = getTargetProject();
+        BuildConfiguration buildConfig = CorePlugin.configurationManager().loadProjectConfiguration(project).getBuildConfiguration();
+        boolean overrideWorkspaceSettings = buildConfig.isOverrideWorkspaceSettings();
+        this.gradleProjectSettingsComposite.getGradleDistributionGroup().setDistribution(GradleDistributionViewModel.from(buildConfig.getGradleDistribution()));
+        this.gradleProjectSettingsComposite.getAdvancedOptionsGroup().setGradleUserHome(buildConfig.getGradleUserHome());
+        this.gradleProjectSettingsComposite.getAdvancedOptionsGroup().setJavaHome(buildConfig.getJavaHome());
+        this.gradleProjectSettingsComposite.getAdvancedOptionsGroup().setArguments(buildConfig.getArguments());
+        this.gradleProjectSettingsComposite.getAdvancedOptionsGroup().setJvmArguments(buildConfig.getJvmArguments());
+        this.gradleProjectSettingsComposite.getOverrideBuildSettingsCheckbox().setSelection(overrideWorkspaceSettings);
+        this.gradleProjectSettingsComposite.getBuildScansCheckbox().setSelection(buildConfig.isBuildScansEnabled());
+        this.gradleProjectSettingsComposite.getOfflineModeCheckbox().setSelection(buildConfig.isOfflineMode());
+        this.gradleProjectSettingsComposite.getAutoSyncCheckbox().setSelection(buildConfig.isAutoSync());
+        this.gradleProjectSettingsComposite.getShowConsoleViewCheckbox().setSelection(buildConfig.isShowConsoleView());
+        this.gradleProjectSettingsComposite.getShowExecutionsViewCheckbox().setSelection(buildConfig.isShowExecutionsView());
+        this.gradleProjectSettingsComposite.updateEnablement();
+    }
+
+    private void addListeners() {
+        this.gradleProjectSettingsComposite.getParentPreferenceLink().addSelectionListener(new WorkbenchPreferenceOpeningSelectionListener());
+        AdvancedOptionsGroup advancedOptionsGroup = this.gradleProjectSettingsComposite.getAdvancedOptionsGroup();
+        advancedOptionsGroup.getGradleUserHomeText().addModifyListener(new ValidatingListener<>(this, () -> advancedOptionsGroup.getGradleUserHome(), this.gradleUserHomeValidator));
+        advancedOptionsGroup.getJavaHomeText().addModifyListener(new ValidatingListener<>(this, () -> advancedOptionsGroup.getJavaHome(), this.javaHomeValidator));
+        this.gradleProjectSettingsComposite.getGradleDistributionGroup().addDistributionChangedListener(new GradleDistributionValidatingListener(this, this.distributionValidator));
+    }
+
+    @Override
+    public boolean performOk() {
+       IProject project = getTargetProject();
+       ConfigurationManager manager = CorePlugin.configurationManager();
+       BuildConfiguration currentConfig = manager.loadProjectConfiguration(project).getBuildConfiguration();
+       BuildConfiguration updatedConfig = manager.createBuildConfiguration(currentConfig.getRootProjectDirectory(),
+           this.gradleProjectSettingsComposite.getOverrideBuildSettingsCheckbox().getSelection(),
+           this.gradleProjectSettingsComposite.getGradleDistributionGroup().getDistribution().toGradleDistribution(),
+           this.gradleProjectSettingsComposite.getAdvancedOptionsGroup().getGradleUserHome(),
+           this.gradleProjectSettingsComposite.getAdvancedOptionsGroup().getJavaHome(),
+           this.gradleProjectSettingsComposite.getBuildScansCheckbox().getSelection(),
+           this.gradleProjectSettingsComposite.getOfflineModeCheckbox().getSelection(),
+           this.gradleProjectSettingsComposite.getAutoSyncCheckbox().getSelection(),
+           this.gradleProjectSettingsComposite.getAdvancedOptionsGroup().getArguments(),
+           this.gradleProjectSettingsComposite.getAdvancedOptionsGroup().getJvmArguments(),
+           this.gradleProjectSettingsComposite.getShowConsoleViewCheckbox().getSelection(),
+           this.gradleProjectSettingsComposite.getShowExecutionsViewCheckbox().getSelection());
+       manager.saveBuildConfiguration(updatedConfig);
+       return true;
+    }
+
+    @SuppressWarnings("cast")
+    private IProject getTargetProject() {
+        return (IProject) Platform.getAdapterManager().getAdapter(getElement(), IProject.class);
+    }
+
+    /**
+     * Opens the workspace preferences dialog.
+     */
+    private class WorkbenchPreferenceOpeningSelectionListener implements SelectionListener {
+
+        @Override
+        public void widgetSelected(SelectionEvent e) {
+            openWorkspacePreferences();
+        }
+
+        @Override
+        public void widgetDefaultSelected(SelectionEvent e) {
+            openWorkspacePreferences();
+        }
+
+        private void openWorkspacePreferences() {
+            PreferencesUtil.createPreferenceDialogOn(getShell(), GradleWorkbenchPreferencePage.PAGE_ID, null, null).open();
+        }
+    }
+}
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/preferences/GradleCompositeRootProjectPreferencePage.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/preferences/GradleCompositeRootProjectPreferencePage.java
new file mode 100644
index 0000000000..1afc18af35
--- /dev/null
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/preferences/GradleCompositeRootProjectPreferencePage.java
@@ -0,0 +1,96 @@
+/*******************************************************************************
+ * Copyright (c) 2019 Gradle Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ******************************************************************************/
+
+package org.eclipse.buildship.ui.internal.preferences;
+
+import org.eclipse.jface.layout.GridDataFactory;
+import org.eclipse.jface.layout.GridLayoutFactory;
+import org.eclipse.swt.SWT;
+import org.eclipse.swt.layout.GridData;
+import org.eclipse.swt.layout.GridLayout;
+import org.eclipse.swt.widgets.Button;
+import org.eclipse.swt.widgets.Composite;
+import org.eclipse.swt.widgets.Control;
+import org.eclipse.swt.widgets.Label;
+import org.eclipse.swt.widgets.Layout;
+import org.eclipse.swt.widgets.Text;
+import org.eclipse.ui.dialogs.PropertyPage;
+
+import org.eclipse.buildship.ui.internal.util.layout.LayoutUtils;
+import org.eclipse.buildship.ui.internal.wizard.workspacecomposite.WorkspaceCompositeWizardMessages;
+
+/**
+ * Preference page for composite root project.
+ *
+ * @author Sebastian Kuzniarz
+ */
+
+public final class GradleCompositeRootProjectPreferencePage extends PropertyPage {
+
+    public static final String PAGE_ID = "org.eclipse.buildship.ui.compositeRootProjectProperties";
+
+    private Text workspaceCompositeRootProjectLabel;
+    private Text overrideCheckboxLabel;
+    private Button overrideSettingsCheckbox;
+    private Button selectRootProject;
+    private Composite rootProjectSettingsComposite;
+    private Label rootProjectLabel;
+
+    private Layout createLayout() {
+        GridLayout layout = LayoutUtils.newGridLayout(2);
+        layout.horizontalSpacing = 4;
+        layout.verticalSpacing = 4;
+        return layout;
+    }
+
+    @Override
+    protected Control createContents(Composite parent) {
+
+        this.rootProjectSettingsComposite = new Composite(parent, SWT.NONE);
+        this.rootProjectSettingsComposite.setLayout(createLayout());
+
+        this.overrideSettingsCheckbox = new Button(this.rootProjectSettingsComposite, SWT.CHECK);
+        this.overrideSettingsCheckbox.setText("Use project as composite root");
+        GridDataFactory.swtDefaults().applyTo(this.rootProjectSettingsComposite);
+
+        Label line = new Label(this.rootProjectSettingsComposite, SWT.SEPARATOR | SWT.HORIZONTAL);
+        GridDataFactory.fillDefaults().align(SWT.FILL, SWT.CENTER).span(2, 1).applyTo(line);
+
+        // composite root container
+        Composite workspaceCompositeNameComposite = new Composite(this.rootProjectSettingsComposite, SWT.NONE);
+        GridLayoutFactory.swtDefaults().extendedMargins(0, 0, 0, 10).numColumns(3).applyTo(workspaceCompositeNameComposite);
+        GridDataFactory.swtDefaults().align(SWT.FILL, SWT.TOP).grab(true, false).span(3, SWT.DEFAULT).applyTo(workspaceCompositeNameComposite);
+
+        // root project label
+        this.rootProjectLabel = new Label(workspaceCompositeNameComposite, SWT.NONE);
+        this.rootProjectLabel.setLayoutData(new GridData(SWT.LEFT, SWT.CENTER, false, false, 1, 1));
+        this.rootProjectLabel.setText(WorkspaceCompositeWizardMessages.Label_RootProject);
+
+        // root project text field
+        this.workspaceCompositeRootProjectLabel = new Text(workspaceCompositeNameComposite, SWT.BORDER);
+        this.workspaceCompositeRootProjectLabel.setLayoutData(new GridData(SWT.FILL, SWT.CENTER, true, false, 1, 1));
+
+        // root project select button
+        this.selectRootProject = new Button(workspaceCompositeNameComposite, SWT.PUSH);
+        this.selectRootProject.setLayoutData(new GridData(SWT.RIGHT, SWT.CENTER, false, false, 1, 1));
+        this.selectRootProject.setText(WorkspaceCompositeWizardMessages.Button_Select_RootProject);
+        return this.rootProjectSettingsComposite;
+    }
+
+    @Override
+    public void dispose() {
+        super.dispose();
+    }
+
+    @Override
+    public boolean performOk() {
+       return true;
+    }
+}
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/preferences/GradleWorkspaceCompositePreferencePage.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/preferences/GradleWorkspaceCompositePreferencePage.java
new file mode 100644
index 0000000000..63d52f0aa1
--- /dev/null
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/preferences/GradleWorkspaceCompositePreferencePage.java
@@ -0,0 +1,71 @@
+/*******************************************************************************
+ * Copyright (c) 2019 Gradle Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ******************************************************************************/
+
+package org.eclipse.buildship.ui.internal.preferences;
+
+import org.eclipse.jface.layout.GridDataFactory;
+import org.eclipse.jface.layout.GridLayoutFactory;
+import org.eclipse.swt.SWT;
+import org.eclipse.swt.layout.GridData;
+import org.eclipse.swt.widgets.Composite;
+import org.eclipse.swt.widgets.Control;
+import org.eclipse.swt.widgets.Label;
+import org.eclipse.swt.widgets.Text;
+import org.eclipse.ui.dialogs.PropertyPage;
+
+import org.eclipse.buildship.ui.internal.util.layout.LayoutUtils;
+import org.eclipse.buildship.ui.internal.util.widget.GradleProjectGroup;
+import org.eclipse.buildship.ui.internal.wizard.workspacecomposite.WorkspaceCompositeWizardMessages;
+
+/**
+ * Preference page for workspace composite configuration.
+ *
+ * @author Sebastian Kuzniarz
+ */
+@SuppressWarnings("unused")
+public final class GradleWorkspaceCompositePreferencePage extends PropertyPage {
+
+    public static final String PAGE_ID = "org.eclipse.buildship.ui.compositeproperties";
+
+    private Text workspaceCompositeNameText;
+    private Label compositeName;
+    private GradleProjectGroup gradleProjectCheckboxtreeComposite;
+    private Composite gradleWorkspaceCompositeSettingsComposite;
+
+    @Override
+    protected Control createContents(Composite parent) {
+        this.gradleWorkspaceCompositeSettingsComposite = new Composite(parent, SWT.FILL);
+        this.gradleWorkspaceCompositeSettingsComposite.setLayout(LayoutUtils.newGridLayout(2));
+
+        // composite name container
+        Composite workspaceCompositeNameComposite = new Composite(this.gradleWorkspaceCompositeSettingsComposite, SWT.FILL);
+        GridLayoutFactory.fillDefaults().extendedMargins(0, 0, 0, 5).numColumns(2).applyTo(workspaceCompositeNameComposite);
+        GridDataFactory.fillDefaults().align(SWT.FILL, SWT.TOP).grab(true, false).span(3, SWT.DEFAULT).applyTo(workspaceCompositeNameComposite);
+
+        // composite name label
+        this.compositeName = new Label(workspaceCompositeNameComposite, SWT.NONE);
+        this.compositeName.setLayoutData(new GridData(SWT.LEFT, SWT.CENTER, false, false, 1, 1));
+        this.compositeName.setText(WorkspaceCompositeWizardMessages.Label_CompositeName);
+
+        // composite name text field
+        this.workspaceCompositeNameText = new Text(workspaceCompositeNameComposite, SWT.BORDER);
+        this.workspaceCompositeNameText.setLayoutData(new GridData(SWT.FILL, SWT.CENTER, true, false, 1, 1));
+
+        this.gradleProjectCheckboxtreeComposite = new GradleProjectGroup(this.gradleWorkspaceCompositeSettingsComposite);
+        GridDataFactory.swtDefaults().align(SWT.FILL, SWT.FILL).grab(true, true).span(3, SWT.DEFAULT).applyTo(this.gradleProjectCheckboxtreeComposite);
+
+        return this.gradleWorkspaceCompositeSettingsComposite;
+    }
+
+    @Override
+    public boolean performOk() {
+       return true;
+    }
+}
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/util/widget/GradleProjectGroup.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/util/widget/GradleProjectGroup.java
new file mode 100644
index 0000000000..c23d4511b5
--- /dev/null
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/util/widget/GradleProjectGroup.java
@@ -0,0 +1,85 @@
+/*******************************************************************************
+ * Copyright (c) 2019 Gradle Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ******************************************************************************/
+
+package org.eclipse.buildship.ui.internal.util.widget;
+
+import org.eclipse.jface.layout.GridLayoutFactory;
+import org.eclipse.swt.SWT;
+import org.eclipse.swt.graphics.Font;
+import org.eclipse.swt.layout.GridData;
+import org.eclipse.swt.widgets.Button;
+import org.eclipse.swt.widgets.Composite;
+import org.eclipse.swt.widgets.Group;
+import org.eclipse.swt.widgets.Tree;
+import org.eclipse.swt.widgets.TreeItem;
+
+import org.eclipse.buildship.ui.internal.wizard.workspacecomposite.WorkspaceCompositeWizardMessages;
+
+@SuppressWarnings("unused")
+public class GradleProjectGroup extends Group {
+
+    private Font font;
+    private Button newGradleProject;
+    private Button addExternalGradleProject;
+    private Composite buttonComposite;
+    private Tree gradleProjectTree;
+
+    public GradleProjectGroup(Composite parent) {
+        super(parent, SWT.NONE);
+        setText(WorkspaceCompositeWizardMessages.Group_Label_GradleProjects);
+        createWidgets();
+    }
+
+    public void createWidgets() {
+        setLayoutData(new GridData(SWT.FILL, SWT.FILL, true, true));
+        GridLayoutFactory.swtDefaults().numColumns(4).applyTo(this);
+
+        this.gradleProjectTree = new Tree(this, SWT.CHECK);
+        this.gradleProjectTree.setLayoutData(new GridData(SWT.FILL, SWT.FILL, true, true, 3, 1));
+
+        this.buttonComposite = new Composite(this, SWT.NONE);
+        this.buttonComposite.setLayoutData(new GridData(SWT.FILL, SWT.TOP, false, true, 1, 1));
+        GridLayoutFactory.fillDefaults().numColumns(1).applyTo(this.buttonComposite);
+
+        this.newGradleProject = new Button(this.buttonComposite, SWT.PUSH);
+        this.newGradleProject.setText(WorkspaceCompositeWizardMessages.Button_New_GradleProject);
+        this.newGradleProject.setLayoutData(new GridData(SWT.FILL, SWT.CENTER, true, false, 1, 1));
+
+        this.addExternalGradleProject = new Button(this.buttonComposite, SWT.PUSH);
+        this.addExternalGradleProject.setText(WorkspaceCompositeWizardMessages.Button_Add_ExternalGradleProject);
+        this.addExternalGradleProject.setLayoutData(new GridData(SWT.FILL, SWT.CENTER, true, false, 1, 1));
+
+        fillCheckboxTreeWithFakeData();
+    }
+
+    private void fillCheckboxTreeWithFakeData() {
+        for (int i = 0; i < 4; i++) {
+            TreeItem iItem = new TreeItem(this.gradleProjectTree, 0);
+            iItem.setText("TreeItem (0) -" + i);
+            for (int j = 0; j < 4; j++) {
+                TreeItem jItem = new TreeItem(iItem, 0);
+                jItem.setText("TreeItem (1) -" + j);
+                for (int k = 0; k < 4; k++) {
+                    TreeItem kItem = new TreeItem(jItem, 0);
+                    kItem.setText("TreeItem (2) -" + k);
+                    for (int l = 0; l < 4; l++) {
+                        TreeItem lItem = new TreeItem(kItem, 0);
+                        lItem.setText("TreeItem (3) -" + l);
+                    }
+                }
+            }
+        }
+    }
+
+    @Override
+    protected void checkSubclass() {
+        // Disable the check that prevents subclassing of SWT components
+    }
+}
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/util/widget/UiBuilder.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/util/widget/UiBuilder.java
index e4bc15aaa7..5cb2a45d94 100644
--- a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/util/widget/UiBuilder.java
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/util/widget/UiBuilder.java
@@ -85,6 +85,16 @@ public UiBuilder<T> alignFillHorizontal() {
         return this;
     }
 
+    /**
+     * Aligns the created widget to fill the cell vertically aligned at top.
+     *
+     * @return the builder
+     */
+    public UiBuilder<T> alignFillVerticalTop() {
+        this.control.setLayoutData(new GridData(SWT.FILL, SWT.TOP, false, true, 1, 1));
+        return this;
+    }
+
     /**
      * Aligns the created widget to fill both horizontal and vertical.
      *
@@ -177,6 +187,17 @@ public UiBuilder<Label> newLabel(Composite parent) {
             return builder;
         }
 
+        /**
+         * Creates a new {@link Composite} control.
+         *
+         * @param parent the parent control
+         * @return the builder
+         */
+        public UiBuilder<Composite> newComposite(Composite parent) {
+            UiBuilder<Composite> builder = new UiBuilder<>(new Composite(parent, SWT.NONE));
+            return builder;
+        }
+
         /**
          * Creates a new {@link Text} control.
          *
@@ -251,6 +272,18 @@ public UiBuilder<Tree> newTree(Composite parent) {
             return builder;
         }
 
+        /**
+         * Creates a new {@link CheckboxTree} control.
+         *
+         * @param parent The parent control of the result tree.
+         * @return the builder
+         */
+        public UiBuilder<Tree> newCheckboxTree(Composite parent) {
+            UiBuilder<Tree> builder = new UiBuilder<>(new Tree(parent, SWT.CHECK));
+            init(builder);
+            return builder;
+        }
+
         /**
          * Creates a new {@link Group} control.
          *
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/HelpContextIdProvider.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/HelpContextIdProvider.java
similarity index 92%
rename from org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/HelpContextIdProvider.java
rename to org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/HelpContextIdProvider.java
index f803e0225c..d5f4bb5c35 100644
--- a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/HelpContextIdProvider.java
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/HelpContextIdProvider.java
@@ -7,7 +7,7 @@
  *
  * SPDX-License-Identifier: EPL-2.0
  ******************************************************************************/
-package org.eclipse.buildship.ui.internal.wizard.project;
+package org.eclipse.buildship.ui.internal.wizard;
 
 /**
  * Implemented by components for which there is a help context id.
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/WizardHelper.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/WizardHelper.java
similarity index 89%
rename from org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/WizardHelper.java
rename to org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/WizardHelper.java
index 0e3e760308..e319302c35 100644
--- a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/WizardHelper.java
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/WizardHelper.java
@@ -7,7 +7,7 @@
  *
  * SPDX-License-Identifier: EPL-2.0
  ******************************************************************************/
-package org.eclipse.buildship.ui.internal.wizard.project;
+package org.eclipse.buildship.ui.internal.wizard;
 
 import java.lang.reflect.InvocationTargetException;
 
@@ -31,7 +31,7 @@ private WizardHelper() {
      * @param exception the target exception
      * @return the new status object
      */
-    static ToolingApiStatus containerExceptionToToolingApiStatus(InvocationTargetException exception) {
+    public static ToolingApiStatus containerExceptionToToolingApiStatus(InvocationTargetException exception) {
         Throwable target = exception.getTargetException() == null ? exception : exception.getTargetException();
         if (target instanceof CoreException && ((CoreException) target).getStatus() instanceof ToolingApiStatus) {
            return (ToolingApiStatus) ((CoreException) target).getStatus();
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/AbstractProjectWizard.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/AbstractProjectWizard.java
index c831d95586..d4e5e5df12 100644
--- a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/AbstractProjectWizard.java
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/AbstractProjectWizard.java
@@ -11,6 +11,8 @@
 
 import org.eclipse.jface.wizard.Wizard;
 
+import org.eclipse.buildship.ui.internal.wizard.HelpContextIdProvider;
+
 /**
  * Base class for project wizards.
  */
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/AbstractWizardPage.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/AbstractWizardPage.java
index af56f46b44..d4ebbe7a23 100644
--- a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/AbstractWizardPage.java
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/AbstractWizardPage.java
@@ -26,6 +26,7 @@
 import org.eclipse.buildship.core.internal.util.binding.Property;
 import org.eclipse.buildship.core.internal.util.binding.ValidationListener;
 import org.eclipse.buildship.ui.internal.util.widget.UiBuilder;
+import org.eclipse.buildship.ui.internal.wizard.HelpContextIdProvider;
 
 /**
  * Common base class for all pages in the {@link ProjectImportWizard}.
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/ProjectImportWizardController.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/ProjectImportWizardController.java
index ddc9513fe4..2fec423d4b 100644
--- a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/ProjectImportWizardController.java
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/ProjectImportWizardController.java
@@ -52,6 +52,7 @@
 import org.eclipse.buildship.ui.internal.util.workbench.WorkingSetUtils;
 import org.eclipse.buildship.ui.internal.view.execution.ExecutionsView;
 import org.eclipse.buildship.ui.internal.view.task.TaskView;
+import org.eclipse.buildship.ui.internal.wizard.WizardHelper;
 
 /**
  * Controller class for the {@link ProjectImportWizard}. Contains all non-UI related calculations
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/ProjectPreviewWizardPage.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/ProjectPreviewWizardPage.java
index 97f792db89..67dba96fa3 100644
--- a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/ProjectPreviewWizardPage.java
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/project/ProjectPreviewWizardPage.java
@@ -71,6 +71,7 @@
 import org.eclipse.buildship.ui.internal.util.gradle.GradleDistributionViewModel.Type;
 import org.eclipse.buildship.ui.internal.util.layout.LayoutUtils;
 import org.eclipse.buildship.ui.internal.util.widget.UiBuilder;
+import org.eclipse.buildship.ui.internal.wizard.WizardHelper;
 
 /**
  * Page in the {@link ProjectImportWizard} showing a preview about the project about to be imported.
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/AbstractWizardPage.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/AbstractWizardPage.java
new file mode 100644
index 0000000000..0d00ff0fae
--- /dev/null
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/AbstractWizardPage.java
@@ -0,0 +1,178 @@
+/*******************************************************************************
+ * Copyright (c) 2019 Gradle Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ******************************************************************************/
+
+package org.eclipse.buildship.ui.internal.wizard.workspacecomposite;
+
+import org.eclipse.buildship.ui.internal.util.font.FontUtils;
+import org.eclipse.buildship.ui.internal.util.widget.UiBuilder;
+import org.eclipse.buildship.ui.internal.wizard.HelpContextIdProvider;
+import org.eclipse.buildship.ui.internal.wizard.project.ProjectImportWizard;
+import org.eclipse.jface.resource.ImageDescriptor;
+import org.eclipse.jface.wizard.WizardPage;
+import org.eclipse.swt.SWT;
+import org.eclipse.swt.custom.ScrolledComposite;
+import org.eclipse.swt.custom.StyledText;
+import org.eclipse.swt.graphics.Font;
+import org.eclipse.swt.graphics.Point;
+import org.eclipse.swt.layout.GridData;
+import org.eclipse.swt.layout.GridLayout;
+import org.eclipse.swt.widgets.Composite;
+import org.eclipse.swt.widgets.Label;
+import org.eclipse.ui.PlatformUI;
+
+import com.google.common.base.Strings;
+
+/**
+ * Common base class for all pages in the {@link ProjectImportWizard}.
+ */
+public abstract class AbstractWizardPage extends WizardPage {
+
+    @SuppressWarnings("unused")
+    private final String defaultMessage;
+    private final Font defaultFont;
+    private final UiBuilder.UiBuilderFactory builderFactory;
+
+    /**
+     * Constructor setting up the main messages and the validation facility for this wizard page.
+     *
+     * @param name the name of the page
+     * @param title the page title
+     * @param defaultMessage the default message to show when there is no validation error
+     */
+    protected AbstractWizardPage(String name, String title, String defaultMessage) {
+        super(name);
+
+        this.defaultMessage = defaultMessage;
+
+        // set the basic message and the attached image
+        setTitle(title);
+        setMessage(defaultMessage);
+        setImageDescriptor(ImageDescriptor.createFromFile(GradleCreateWorkspaceCompositeWizardPage.class, "/icons/full/wizban/wizard.png")); //$NON-NLS-1$
+
+        // set up the UI builder
+        this.defaultFont = FontUtils.getCustomDialogFont(SWT.NORMAL);
+        this.builderFactory = new UiBuilder.UiBuilderFactory(this.defaultFont);
+
+    }
+
+    protected UiBuilder.UiBuilderFactory getUiBuilderFactory() {
+        return this.builderFactory;
+    }
+
+    @Override
+    public final void createControl(Composite parent) {
+        // align dialog units to the current resolution
+        initializeDialogUnits(parent);
+
+        // create the container control
+        Composite pageControl = createWizardPageContent(parent);
+
+        // assign the created control to the wizard page
+        setControl(pageControl);
+    }
+
+    private Composite createWizardPageContent(Composite parent) {
+        // create a scrollable root to handle resizing
+        ScrolledComposite externalRoot = new ScrolledComposite(parent, SWT.H_SCROLL | SWT.V_SCROLL);
+        externalRoot.setExpandHorizontal(true);
+        externalRoot.setExpandVertical(true);
+        externalRoot.setMinSize(new Point(230, 380));
+
+        // add the controls inside the root composite
+        Composite container = new Composite(externalRoot, SWT.NONE);
+        createWidgets(container);
+
+        // add context information to the bottom of the page if the page defines it
+        String contextInformation = Strings.emptyToNull(getPageContextInformation());
+        if (contextInformation != null) {
+            createWidgetsForContextInformation(container, contextInformation);
+        }
+
+        // also compute the size of the container, otherwise the ScrolledComposite's content is not
+        // rendered properly
+        Point containerSize = container.computeSize(SWT.DEFAULT, SWT.DEFAULT);
+        container.setSize(containerSize);
+
+        // set the root's content and return it
+        externalRoot.setContent(container);
+        return externalRoot;
+    }
+
+    /**
+     * Populates the widgets in the wizard page.
+     */
+    protected abstract void createWidgets(Composite root);
+
+    private void createWidgetsForContextInformation(Composite root, String contextInformation) {
+        // create a container box occupying all horizontal space and has a 1-column row layout and a
+        // 30 pixel margin to not stretch the separator widgets to the edge of the wizard page
+        Composite contextInformationContainer = new Composite(root, SWT.NONE);
+        GridLayout contextInformationContainerLayout = new GridLayout(1, false);
+        contextInformationContainerLayout.marginLeft = contextInformationContainerLayout.marginRight = contextInformationContainerLayout.marginTop = 30;
+        contextInformationContainerLayout.verticalSpacing = 15;
+        contextInformationContainer.setLayout(contextInformationContainerLayout);
+        contextInformationContainer.setLayoutData(new GridData(SWT.FILL, SWT.TOP, true, false, 3, 1));
+
+        // separator widget
+        Label separator = new Label(contextInformationContainer, SWT.HORIZONTAL | SWT.SEPARATOR);
+        separator.setLayoutData(new GridData(SWT.FILL, SWT.BOTTOM, true, false));
+
+        // internal container for flexible resize
+        Composite textContainer = new Composite(contextInformationContainer, SWT.NONE);
+        textContainer.setLayoutData(new GridData(SWT.FILL, SWT.FILL, true, false, 1, 1));
+        GridLayout textContainerLayout = new GridLayout(1, false);
+        textContainerLayout.marginLeft = textContainerLayout.marginRight = 50;
+        textContainer.setLayout(textContainerLayout);
+
+        // text widget aligned to the center having 400 pixels allocated for each line of content
+        StyledText contextInformationText = new StyledText(textContainer, SWT.WRAP | SWT.MULTI | SWT.CENTER);
+        contextInformationText.setText(contextInformation);
+        contextInformationText.setBackground(contextInformationText.getParent().getBackground());
+        contextInformationText.setEnabled(false);
+        contextInformationText.setEditable(false);
+        GridData contextInformationTextLayoutData = new GridData(SWT.CENTER, SWT.CENTER, true, false, 1, 1);
+        contextInformationTextLayoutData.widthHint = 400;
+        contextInformationText.setLayoutData(contextInformationTextLayoutData);
+    }
+
+    /**
+     * Returns text to display under the widgets. If {@code null} or empty then nothing is displayed.
+     *
+     * @return explanation text for for the wizard page
+     */
+    protected abstract String getPageContextInformation();
+
+    @Override
+    public void setVisible(boolean visible) {
+        super.setVisible(visible);
+
+        // every time the page becomes visible, set the proper help context, this is required since
+        // the user could navigate back to the initial Eclipse import page which sets another help
+        // context
+        if (visible) {
+            if (getWizard() instanceof HelpContextIdProvider) {
+                String helpContextId = ((HelpContextIdProvider) getWizard()).getHelpContextId();
+                PlatformUI.getWorkbench().getHelpSystem().setHelp(getControl(), helpContextId);
+            }
+        }
+    }
+
+    @Override
+    public boolean isPageComplete() {
+        return true;
+    }
+
+    @Override
+    public void dispose() {
+        this.defaultFont.dispose();
+        super.dispose();
+    }
+
+}
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/AbstractWorkspaceCompositeWizard.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/AbstractWorkspaceCompositeWizard.java
new file mode 100644
index 0000000000..e2022669c9
--- /dev/null
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/AbstractWorkspaceCompositeWizard.java
@@ -0,0 +1,73 @@
+/*******************************************************************************
+ * Copyright (c) 2019 Gradle Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ******************************************************************************/
+
+package org.eclipse.buildship.ui.internal.wizard.workspacecomposite;
+
+import org.eclipse.buildship.core.internal.GradlePluginsRuntimeException;
+import org.eclipse.buildship.ui.internal.UiPlugin;
+import org.eclipse.buildship.ui.internal.wizard.HelpContextIdProvider;
+import org.eclipse.core.runtime.preferences.ConfigurationScope;
+import org.eclipse.core.runtime.preferences.IEclipsePreferences;
+import org.eclipse.jface.wizard.Wizard;
+import org.osgi.service.prefs.BackingStoreException;
+
+import com.google.common.base.Preconditions;
+
+/**
+ * Base class for project wizards.
+ */
+public abstract class AbstractWorkspaceCompositeWizard extends Wizard implements HelpContextIdProvider {
+
+    // the preference key under which it is stored whether to show the welcome page or not
+    private final String welcomePageEnabledPreferenceKey;
+
+    // state bit storing that the wizard is blocked to finish globally
+    private boolean finishGloballyEnabled;
+
+    protected AbstractWorkspaceCompositeWizard(String welcomePageEnabledPreferenceKey) {
+        this.welcomePageEnabledPreferenceKey = Preconditions.checkNotNull(welcomePageEnabledPreferenceKey);
+
+        // the wizard must not be finishable unless this global flag is enabled
+        this.finishGloballyEnabled = true;
+    }
+
+    public boolean isShowWelcomePage() {
+        // store the in the configuration scope to have the same settings for
+        // all workspaces
+        @SuppressWarnings("deprecation")
+        ConfigurationScope configurationScope = new ConfigurationScope();
+        IEclipsePreferences node = configurationScope.getNode(UiPlugin.PLUGIN_ID);
+        return node.getBoolean(this.welcomePageEnabledPreferenceKey, true);
+    }
+
+    public void setWelcomePageEnabled(boolean enabled) {
+        @SuppressWarnings("deprecation")
+        ConfigurationScope configurationScope = new ConfigurationScope();
+        IEclipsePreferences node = configurationScope.getNode(UiPlugin.PLUGIN_ID);
+        node.putBoolean(this.welcomePageEnabledPreferenceKey, enabled);
+        try {
+            node.flush();
+        } catch (BackingStoreException e) {
+            throw new GradlePluginsRuntimeException(e);
+        }
+    }
+
+    @Override
+    public boolean canFinish() {
+        // the wizard can finish if all pages are complete and the finish is
+        // globally enabled
+        return super.canFinish() && this.finishGloballyEnabled;
+    }
+
+    public void setFinishGloballyEnabled(boolean finishGloballyEnabled) {
+        this.finishGloballyEnabled = finishGloballyEnabled;
+    }
+
+}
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/GradleCreateWorkspaceCompositeWizardPage.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/GradleCreateWorkspaceCompositeWizardPage.java
new file mode 100644
index 0000000000..a95e79b247
--- /dev/null
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/GradleCreateWorkspaceCompositeWizardPage.java
@@ -0,0 +1,69 @@
+/*******************************************************************************
+ * Copyright (c) 2019 Gradle Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ******************************************************************************/
+
+package org.eclipse.buildship.ui.internal.wizard.workspacecomposite;
+
+import org.eclipse.jface.layout.GridDataFactory;
+import org.eclipse.jface.layout.GridLayoutFactory;
+import org.eclipse.swt.SWT;
+import org.eclipse.swt.layout.GridData;
+import org.eclipse.swt.widgets.Composite;
+import org.eclipse.swt.widgets.Label;
+import org.eclipse.swt.widgets.Text;
+
+import org.eclipse.buildship.ui.internal.util.layout.LayoutUtils;
+import org.eclipse.buildship.ui.internal.util.widget.GradleProjectGroup;
+
+/**
+ * Page on the {@link WorkspaceCompositeCreationWizard} declaring the workspace composite name and included projects.
+ */
+public final class GradleCreateWorkspaceCompositeWizardPage extends AbstractWizardPage {
+    @SuppressWarnings("unused")
+    private Text workspaceCompositeNameText;
+    private Label compositeName;
+    private GradleProjectGroup gradleProjectCheckboxtreeComposite;
+
+    public GradleCreateWorkspaceCompositeWizardPage() {
+        super("NewGradleWorkspaceComposite", WorkspaceCompositeWizardMessages.Title_NewGradleWorkspaceCompositeWizardPage, WorkspaceCompositeWizardMessages.InfoMessage_NewGradleWorkspaceCompositeWizardPageDefault); //$NON-NLS-1$
+    }
+
+    @Override
+    protected void createWidgets(Composite root) {
+        root.setLayout(LayoutUtils.newGridLayout(3));
+        createContent(root);
+    }
+
+    private void createContent(Composite root) {
+
+        // composite name container
+        Composite workspaceCompositeNameComposite = new Composite(root, SWT.FILL);
+        GridLayoutFactory.fillDefaults().extendedMargins(0, 0, 0, 5).numColumns(2).applyTo(workspaceCompositeNameComposite);
+        GridDataFactory.fillDefaults().align(SWT.FILL, SWT.TOP).grab(true, false).span(3, SWT.DEFAULT).applyTo(workspaceCompositeNameComposite);
+
+        // composite name label
+        this.compositeName = new Label(workspaceCompositeNameComposite, SWT.NONE);
+        this.compositeName.setLayoutData(new GridData(SWT.LEFT, SWT.CENTER, false, false, 1, 1));
+        this.compositeName.setText(WorkspaceCompositeWizardMessages.Label_CompositeName);
+
+        // composite name text field
+        this.workspaceCompositeNameText = new Text(workspaceCompositeNameComposite, SWT.BORDER);
+        this.workspaceCompositeNameText.setLayoutData(new GridData(SWT.FILL, SWT.CENTER, true, false, 1, 1));
+
+        this.gradleProjectCheckboxtreeComposite = new GradleProjectGroup(root);
+        GridDataFactory.swtDefaults().align(SWT.FILL, SWT.FILL).grab(true, true).span(3, SWT.DEFAULT).applyTo(this.gradleProjectCheckboxtreeComposite);
+
+    }
+
+    @Override
+    protected String getPageContextInformation() {
+        return WorkspaceCompositeWizardMessages.InfoMessage_NewGradleWorkspaceCompositeWizardPageContext;
+    }
+
+}
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/GradleImportOptionsWizardPage.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/GradleImportOptionsWizardPage.java
new file mode 100644
index 0000000000..0ff1207239
--- /dev/null
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/GradleImportOptionsWizardPage.java
@@ -0,0 +1,77 @@
+/*******************************************************************************
+ * Copyright (c) 2019 Gradle Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ******************************************************************************/
+package org.eclipse.buildship.ui.internal.wizard.workspacecomposite;
+
+import org.eclipse.jface.layout.GridDataFactory;
+import org.eclipse.jface.layout.GridLayoutFactory;
+import org.eclipse.swt.events.SelectionEvent;
+import org.eclipse.swt.events.SelectionListener;
+import org.eclipse.swt.widgets.Composite;
+import org.eclipse.ui.dialogs.PreferencesUtil;
+
+import org.eclipse.buildship.ui.internal.preferences.GradleWorkbenchPreferencePage;
+import org.eclipse.buildship.ui.internal.util.widget.GradleProjectSettingsComposite;
+
+/**
+ * Page on the {@link WorkspaceCompositeCreationWizard} declaring the used Gradle distribution and other advanced options for the composite projects.
+ */
+public final class GradleImportOptionsWizardPage extends AbstractWizardPage {
+
+    private final String pageContextInformation;
+
+    private GradleProjectSettingsComposite gradleProjectSettingsComposite;
+
+    public GradleImportOptionsWizardPage() {
+        this(WorkspaceCompositeWizardMessages.Title_GradleImportOptionsWizardPage, WorkspaceCompositeWizardMessages.InfoMessage_NewGradleWorkspaceCompositeOptionsWizardPageDefault,
+                WorkspaceCompositeWizardMessages.InfoMessage_GradleImportOptionsWizardPageContext);
+    }
+
+    public GradleImportOptionsWizardPage(String title, String defaultMessage, String pageContextInformation) {
+        super("GradleImportOptions", title, defaultMessage);
+        this.pageContextInformation = pageContextInformation;
+    }
+
+    @Override
+    protected void createWidgets(Composite root) {
+        GridLayoutFactory.swtDefaults().applyTo(root);
+        this.gradleProjectSettingsComposite = GradleProjectSettingsComposite.builder(root)
+                .withOverrideCheckbox("Override workspace settings", "Configure Workspace Settings")
+                .withAutoSyncCheckbox()
+                .build();
+
+        GridDataFactory.fillDefaults().grab(true, false).applyTo(this.gradleProjectSettingsComposite);
+        this.gradleProjectSettingsComposite.getParentPreferenceLink().addSelectionListener(new WorkbenchPreferenceOpeningSelectionListener());
+    }
+
+    @Override
+    protected String getPageContextInformation() {
+        return this.pageContextInformation;
+    }
+
+    /**
+     * Opens the workspace preferences dialog.
+     */
+    private class WorkbenchPreferenceOpeningSelectionListener implements SelectionListener {
+
+        @Override
+        public void widgetSelected(SelectionEvent e) {
+            openWorkspacePreferences();
+        }
+
+        @Override
+        public void widgetDefaultSelected(SelectionEvent e) {
+            openWorkspacePreferences();
+        }
+
+        private void openWorkspacePreferences() {
+            PreferencesUtil.createPreferenceDialogOn(getShell(), GradleWorkbenchPreferencePage.PAGE_ID, null, null).open();
+        }
+    }
+}
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/GradleRootProjectWizardPage.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/GradleRootProjectWizardPage.java
new file mode 100644
index 0000000000..a709b48ffc
--- /dev/null
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/GradleRootProjectWizardPage.java
@@ -0,0 +1,100 @@
+/*******************************************************************************
+ * Copyright (c) 2019 Gradle Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ******************************************************************************/
+
+package org.eclipse.buildship.ui.internal.wizard.workspacecomposite;
+
+import org.eclipse.buildship.ui.internal.util.layout.LayoutUtils;
+import org.eclipse.jface.layout.GridDataFactory;
+import org.eclipse.jface.layout.GridLayoutFactory;
+import org.eclipse.swt.SWT;
+import org.eclipse.swt.layout.GridData;
+import org.eclipse.swt.layout.GridLayout;
+import org.eclipse.swt.widgets.Button;
+import org.eclipse.swt.widgets.Composite;
+import org.eclipse.swt.widgets.Label;
+import org.eclipse.swt.widgets.Layout;
+import org.eclipse.swt.widgets.Text;
+
+/**
+ * Page in the {@link WorkspaceCompositeCreationWizard} for setting a project as composite root.
+ */
+@SuppressWarnings("unused")
+public final class GradleRootProjectWizardPage extends AbstractWizardPage {
+
+    private Text workspaceCompositeRootProjectLabel;
+    private Text overrideCheckboxLabel;
+    private Button overrideSettingsCheckbox;
+    private Button selectRootProject;
+    private Label rootProjectLabel;
+
+    public GradleRootProjectWizardPage() {
+        this(WorkspaceCompositeWizardMessages.Title_CompositeRootWizardPage,
+             WorkspaceCompositeWizardMessages.InfoMessage_CompositeRootWizardPageDefault,
+             WorkspaceCompositeWizardMessages.InfoMessage_CompositeRootWizardPageContext);
+    }
+
+    public GradleRootProjectWizardPage(String title, String defaultMessage,
+            String pageContextInformation) {
+        super("CompositeRootProject", title, defaultMessage); //$NON-NLS-1$
+    }
+
+    @Override
+    protected void createWidgets(Composite root) {
+        root.setLayout(createLayout());
+        createContent(root);
+    }
+
+    private Layout createLayout() {
+        GridLayout layout = LayoutUtils.newGridLayout(2);
+        layout.horizontalSpacing = 4;
+        layout.verticalSpacing = 4;
+        return layout;
+    }
+
+    private void createContent(Composite root) {
+
+        this.overrideSettingsCheckbox = new Button(root, SWT.CHECK);
+        this.overrideSettingsCheckbox.setText("Use project as composite root");
+        GridDataFactory.swtDefaults().applyTo(root);
+
+        Label line = new Label(root, SWT.SEPARATOR | SWT.HORIZONTAL);
+        GridDataFactory.fillDefaults().align(SWT.FILL, SWT.CENTER).span(2, 1).applyTo(line);
+
+        // composite root container
+        Composite workspaceCompositeNameComposite = new Composite(root, SWT.NONE);
+        GridLayoutFactory.swtDefaults().extendedMargins(0, 0, 0, 10).numColumns(3).applyTo(workspaceCompositeNameComposite);
+        GridDataFactory.swtDefaults().align(SWT.FILL, SWT.TOP).grab(true, false).span(3, SWT.DEFAULT).applyTo(workspaceCompositeNameComposite);
+
+        // root project label
+        this.rootProjectLabel = new Label(workspaceCompositeNameComposite, SWT.NONE);
+        this.rootProjectLabel.setLayoutData(new GridData(SWT.LEFT, SWT.CENTER, false, false, 1, 1));
+        this.rootProjectLabel.setText(WorkspaceCompositeWizardMessages.Label_RootProject);
+
+        // root project text field
+        this.workspaceCompositeRootProjectLabel = new Text(workspaceCompositeNameComposite, SWT.BORDER);
+        this.workspaceCompositeRootProjectLabel.setLayoutData(new GridData(SWT.FILL, SWT.CENTER, true, false, 1, 1));
+
+        // root project select button
+        this.selectRootProject = new Button(workspaceCompositeNameComposite, SWT.PUSH);
+        this.selectRootProject.setLayoutData(new GridData(SWT.RIGHT, SWT.CENTER, false, false, 1, 1));
+        this.selectRootProject.setText(WorkspaceCompositeWizardMessages.Button_Select_RootProject);
+    }
+
+    @Override
+    public void dispose() {
+        super.dispose();
+    }
+
+    @Override
+    protected String getPageContextInformation() {
+        // TODO Auto-generated method stub
+        return null;
+    }
+}
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/WorkspaceCompositeCreationWizard.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/WorkspaceCompositeCreationWizard.java
new file mode 100644
index 0000000000..641a4c9675
--- /dev/null
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/WorkspaceCompositeCreationWizard.java
@@ -0,0 +1,126 @@
+/*******************************************************************************
+ * Copyright (c) 2019 Gradle Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ******************************************************************************/
+package org.eclipse.buildship.ui.internal.wizard.workspacecomposite;
+
+import org.eclipse.buildship.ui.internal.UiPlugin;
+import org.eclipse.jface.dialogs.IDialogSettings;
+import org.eclipse.jface.viewers.IStructuredSelection;
+import org.eclipse.jface.wizard.IWizardContainer;
+import org.eclipse.ui.INewWizard;
+import org.eclipse.ui.IWorkbench;
+
+/**
+ * Eclipse wizard for creating Gradle composites in the workspace.
+ */
+public final class WorkspaceCompositeCreationWizard extends AbstractWorkspaceCompositeWizard implements INewWizard {
+
+    /**
+     * The section name declaration for {@link org.eclipse.jface.dialogs.DialogSettings} where the import wizard stores its
+     * preferences.
+     *
+     * @see org.eclipse.jface.dialogs.DialogSettings#getOrCreateSection(IDialogSettings, String)
+     */
+    private static final String PROJECT_CREATION_DIALOG_SETTINGS = "org.eclipse.buildship.ui.wizard.project.creation"; //$NON-NLS-1$
+
+    /**
+     * Preference key that flags whether the welcome page should be shown as part of the creation wizard.
+     */
+    private static final String PREF_SHOW_WELCOME_PAGE = "org.eclipse.buildship.ui.wizard.project.creation.showWelcomePage"; //$NON-NLS-1$
+
+    // the pages to display in the wizard
+    private final GradleCreateWorkspaceCompositeWizardPage newGradleWorkspaceCompositePage;
+    private final GradleImportOptionsWizardPage compositeImportOptionsPage;
+    private final GradleRootProjectWizardPage compositeRootProjectPage;
+
+    /**
+     * Creates a new instance and uses the {@link org.eclipse.jface.dialogs.DialogSettings} from {@link org.eclipse.buildship.ui.internal.UiPlugin}..
+     */
+    public WorkspaceCompositeCreationWizard() {
+        this(getOrCreateDialogSection(UiPlugin.getInstance().getDialogSettings()));
+    }
+
+    /**
+     * Creates a new instance and uses the given {@link org.eclipse.jface.dialogs.DialogSettings}.
+     *
+     * @param dialogSettings          the dialog settings to store/retrieve dialog preferences
+     */
+    public WorkspaceCompositeCreationWizard(IDialogSettings dialogSettings) {
+        super(PREF_SHOW_WELCOME_PAGE);
+
+        // store the dialog settings on the wizard and use them to retrieve / persist the most
+        // recent values entered by the user
+        setDialogSettings(dialogSettings);
+
+        // instantiate the pages and pass the configuration objects that serve as
+        // the data models of the wizard
+        this.newGradleWorkspaceCompositePage = new GradleCreateWorkspaceCompositeWizardPage();
+        this.compositeImportOptionsPage = new GradleImportOptionsWizardPage(
+                WorkspaceCompositeWizardMessages.Title_NewGradleImportOptionsWizardPage,
+                WorkspaceCompositeWizardMessages.InfoMessage_NewGradleWorkspaceCompositeOptionsWizardPageDefault,
+                WorkspaceCompositeWizardMessages.InfoMessage_NewGradleWorkspaceCompositeImportOptionsWizardPageContext);
+        this.compositeRootProjectPage = new GradleRootProjectWizardPage(
+                WorkspaceCompositeWizardMessages.Title_NewGradleCompositeRootWizardPage,
+                WorkspaceCompositeWizardMessages.InfoMessage_NewGradleWorkspaceCompositePreviewWizardPageDefault,
+                WorkspaceCompositeWizardMessages.InfoMessage_NewGradleWorkspaceCompositeCompositeRootWizardPageContext);
+    }
+
+    @Override
+    public void setContainer(IWizardContainer wizardContainer) {
+        super.setContainer(wizardContainer);
+    }
+
+    @Override
+    public void init(IWorkbench workbench, IStructuredSelection selection) {
+    }
+
+    @Override
+    public String getWindowTitle() {
+        return WorkspaceCompositeWizardMessages.Title_NewGradleWorkspaceCompositeWizardPage;
+    }
+
+    @Override
+    public void addPages() {
+        // assign wizard pages to this wizard
+        addPage(this.newGradleWorkspaceCompositePage);
+        addPage(this.compositeImportOptionsPage);
+        addPage(this.compositeRootProjectPage);
+
+        // disable help on all wizard pages
+        setHelpAvailable(false);
+    }
+
+    @Override
+    public boolean performFinish() {
+        return false;
+    }
+
+    @Override
+    public boolean performCancel() {
+        return true;
+    }
+
+    @Override
+    public String getHelpContextId() {
+        return "";
+    }
+
+    @Override
+    public void dispose() {
+        super.dispose();
+    }
+
+    private static IDialogSettings getOrCreateDialogSection(IDialogSettings dialogSettings) {
+        IDialogSettings section = dialogSettings.getSection(PROJECT_CREATION_DIALOG_SETTINGS);
+        if (section == null) {
+            section = dialogSettings.addNewSection(PROJECT_CREATION_DIALOG_SETTINGS);
+        }
+        return section;
+    }
+}
diff --git a/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/WorkspaceCompositeWizardMessages.java b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/WorkspaceCompositeWizardMessages.java
new file mode 100644
index 0000000000..47024e2a61
--- /dev/null
+++ b/org.eclipse.buildship.ui/src/main/java/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/WorkspaceCompositeWizardMessages.java
@@ -0,0 +1,59 @@
+/*******************************************************************************
+ * Copyright (c) 2019 Gradle Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ******************************************************************************/
+
+package org.eclipse.buildship.ui.internal.wizard.workspacecomposite;
+
+import org.eclipse.osgi.util.NLS;
+
+/**
+ * Lists the i18n resource keys for the project import messages.
+ */
+public final class WorkspaceCompositeWizardMessages extends NLS {
+
+    private static final String BUNDLE_NAME = "org.eclipse.buildship.ui.internal.wizard.workspacecomposite.WorkspaceCompositeWizardMessages"; //$NON-NLS-1$
+
+    public static String Title_GradleImportOptionsWizardPage;
+    public static String Title_CompositeRootWizardPage;
+
+    public static String Title_NewGradleWorkspaceCompositeWizardPage;
+    public static String Title_NewGradleImportOptionsWizardPage;
+    public static String Title_NewGradleCompositeRootWizardPage;
+
+    public static String Label_CompositeName;
+
+    public static String InfoMessage_CompositeRootWizardPageDefault;
+
+    public static String InfoMessage_NewGradleWorkspaceCompositeWizardPageDefault;
+    public static String InfoMessage_NewGradleWorkspaceCompositeOptionsWizardPageDefault;
+    public static String InfoMessage_NewGradleWorkspaceCompositePreviewWizardPageDefault;
+
+    public static String InfoMessage_GradleImportOptionsWizardPageContext;
+    public static String InfoMessage_CompositeRootWizardPageContext;
+
+    public static String InfoMessage_NewGradleWorkspaceCompositeWizardPageContext;
+    public static String InfoMessage_NewGradleWorkspaceCompositeImportOptionsWizardPageContext;
+    public static String InfoMessage_NewGradleWorkspaceCompositeCompositeRootWizardPageContext;
+
+    public static String Group_Label_GradleProjects;
+    public static String Button_New_GradleProject;
+    public static String Button_Add_ExternalGradleProject;
+
+    public static String Label_RootProject;
+    public static String Button_Select_RootProject;
+
+    static {
+        // initialize resource bundle
+        NLS.initializeMessages(BUNDLE_NAME, WorkspaceCompositeWizardMessages.class);
+    }
+
+    private WorkspaceCompositeWizardMessages() {
+    }
+
+}
diff --git a/org.eclipse.buildship.ui/src/main/resources/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/WorkspaceCompositeWizardMessages.properties b/org.eclipse.buildship.ui/src/main/resources/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/WorkspaceCompositeWizardMessages.properties
new file mode 100644
index 0000000000..82dcb3f181
--- /dev/null
+++ b/org.eclipse.buildship.ui/src/main/resources/org/eclipse/buildship/ui/internal/wizard/workspacecomposite/WorkspaceCompositeWizardMessages.properties
@@ -0,0 +1,39 @@
+#
+# Copyright (c) 2015 the original author or authors.
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Eclipse Public License v1.0
+# which accompanies this distribution, and is available at
+# http://www.eclipse.org/legal/epl-v10.html
+#
+# Contributors:
+#     Sebastian Kuzniarz (Diebold Nixdorf Inc.) - initial API and implementation and initial documentation
+#
+
+Title_GradleImportOptionsWizardPage=Import Options
+Title_CompositeRootWizardPage=Composite Root
+
+Title_NewGradleWorkspaceCompositeWizardPage=Create a Workspace Composite
+Title_NewGradleImportOptionsWizardPage=Import Options
+Title_NewGradleCompositeRootWizardPage=Composite Root
+
+Label_CompositeName=Composite name
+
+InfoMessage_CompositeRootWizardPageDefault=Specify an optional Root Project to apply when creating and interacting with the Gradle composite.
+
+InfoMessage_NewGradleWorkspaceCompositeWizardPageDefault=Enter a composite name.
+InfoMessage_NewGradleWorkspaceCompositeOptionsWizardPageDefault=Specify optional import options to apply when creating and interacting with the Gradle composite.
+InfoMessage_NewGradleWorkspaceCompositePreviewWizardPageDefault=Specify an optional Root Project to apply when creating and interacting with the Gradle composite.
+
+InfoMessage_GradleImportOptionsWizardPageContext=Specify optional import options to apply when creating and interacting with the Gradle composite.
+InfoMessage_CompositeRootWizardPageContext=Specify an optional Root Project to apply when creating and interacting with the Gradle composite.
+
+InfoMessage_NewGradleWorkspaceCompositeWizardPageContext=Click the Finish button to import the composite into the workspace. Click the Next button to select optional import options.
+InfoMessage_NewGradleWorkspaceCompositeImportOptionsWizardPageContext=Click the Finish button to import the composite into the workspace. Click the Next button to select an optional project as composite root.
+InfoMessage_NewGradleWorkspaceCompositeCompositeRootWizardPageContext=Click the Finish button to import the composite into the workspace. Click the Back button to adjust the import configuration.
+    
+Group_Label_GradleProjects=Gradle projects
+Button_New_GradleProject=New...
+Button_Add_ExternalGradleProject=Add external...
+    
+Label_RootProject=Root project
+Button_Select_RootProject=Select...
\ No newline at end of file