Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
1
Merge Requests
1
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
nexedi
gitlab-ce
Commits
5d4c1f04
Commit
5d4c1f04
authored
Nov 24, 2021
by
Suzanne Selhorn
Committed by
Evan Read
Nov 24, 2021
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Edited for CTRT and style
parent
85390301
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
25 additions
and
25 deletions
+25
-25
doc/user/group/custom_project_templates.md
doc/user/group/custom_project_templates.md
+25
-25
No files found.
doc/user/group/custom_project_templates.md
View file @
5d4c1f04
...
...
@@ -9,49 +9,49 @@ info: To determine the technical writer assigned to the Stage/Group associated w
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/6861) in GitLab 11.6.
[
Group owners
](
../permissions.md#group-members-permissions
)
can set a subgroup to
be the source of project templates that are selectable when a new project is created
in the group. These templates can be selected when you go to
**New project > Create from template**
in the group and select the
**Group**
tab
.
When you create a project, you can
[
choose from a list of templates
](
../project/working_with_projects.md#project-templates
)
.
These templates, for things like GitLab Pages or Ruby, populate the new project with a copy of the files contained in the
template. This information is identical to the information used by
[
GitLab project import/export
](
../project/settings/import_export.md
)
and can help you start a new project more quickly
.
Every project in the subgroup, but not nested subgroups, can be selected by members
of the group when a new project is created.
You can
[
customize the list
](
../project/working_with_projects.md#custom-project-templates
)
of available templates, so
that all projects in your group have the same list. To do this, you populate a subgroup with the projects you want to
use as templates.
-
Public projects can be selected by any signed-in user as a template for a new project,
if all enabled
[
project features
](
../project/settings/index.md#sharing-and-permissions
)
except for
**GitLab Pages**
and
**Security & Compliance**
are set to
**Everyone With Access**
.
The same applies to internal projects.
-
Private projects can be selected only by users who are members of the projects.
You can also configure
[
custom templates for the instance
](
../admin_area/custom_project_templates.md
)
.
Repository and database information that is copied over to each new project is identical to the
data exported with the
[
GitLab Project Import/Export
](
../project/settings/import_export.md
)
.
## Set up group-level project templates
To set custom project templates at the instance level, see
[
Custom instance-level project templates
](
../admin_area/custom_project_templates.md
)
.
Prerequisite:
## Set up group-level project templates
-
You must have the
[
Owner role for the group
](
../permissions.md#group-members-permissions
)
.
To set up custom project templates in a group, add the subgroup that contains the
project templates to the group settings:
1.
In the group, create a
[
subgroup
](
subgroups/index.md
)
.
1.
[
Add projects to the new subgroup
](
index.md#add-projects-to-a-group
)
as your templates.
1.
In the left menu for the group,
go to
**Settings > General**
.
1.
In the left menu for the group,
select
**Settings > General**
.
1.
Expand
**Custom project templates**
and select the subgroup.
If all enabled
[
project features
](
../project/settings/index.md#sharing-and-permissions
)
(except for GitLab Pages) are set to
**Everyone With Access**
, then every project
template in the subgroup is available to every member of the group.
The next time a group member creates a project, they can select any of the projects in the subgroup.
Any projects added to the subgroup later can be selected the next time a group member
creates a new project.
Projects in nested subgroups are not included in the template list.
## Which projects are available as templates
-
Public and internal projects can be selected by any signed-in user as a template for a new project,
if all
[
project features
](
../project/settings/index.md#sharing-and-permissions
)
except for
**GitLab Pages**
and
**Security & Compliance**
are set to
**Everyone With Access**
.
-
Private projects can be selected only by users who are members of the projects.
##
#
Example structure
## Example structure
Here's a sample group
/project structure for project templates, for a hypothetical _Acme Co_
:
Here's a sample group
and project structure for project templates, for
`myorganization`
:
```
plaintext
# GitLab instance and group
gitlab.com/
acmeco
/
gitlab.com/
myorganization
/
# Subgroups
internal
tools
...
...
@@ -61,7 +61,7 @@ gitlab.com/acmeco/
# Project templates
client-site-django
client-site-gatsby
client-site-h
TML
client-site-h
tml
# Other projects
client-site-a
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment