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
...
@@ -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.
> [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
When you create a project, you can
[
choose from a list of templates
](
../project/working_with_projects.md#project-templates
)
.
be the source of project templates that are selectable when a new project is created
These templates, for things like GitLab Pages or Ruby, populate the new project with a copy of the files contained in the
in the group. These templates can be selected when you go to
**New project > Create from template**
template. This information is identical to the information used by
[
GitLab project import/export
](
../project/settings/import_export.md
)
in the group and select the
**Group**
tab
.
and can help you start a new project more quickly
.
Every project in the subgroup, but not nested subgroups, can be selected by members
You can
[
customize the list
](
../project/working_with_projects.md#custom-project-templates
)
of available templates, so
of the group when a new project is created.
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,
You can also configure
[
custom templates for the instance
](
../admin_area/custom_project_templates.md
)
.
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.
Repository and database information that is copied over to each new project is identical to the
## Set up group-level project templates
data exported with the
[
GitLab Project Import/Export
](
../project/settings/import_export.md
)
.
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
To set up custom project templates in a group, add the subgroup that contains the
project templates to the group settings:
project templates to the group settings:
1.
In the group, create a
[
subgroup
](
subgroups/index.md
)
.
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.
[
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.
1.
Expand
**Custom project templates**
and select the subgroup.
If all enabled
[
project features
](
../project/settings/index.md#sharing-and-permissions
)
The next time a group member creates a project, they can select any of the projects in the subgroup.
(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.
Any projects added to the subgroup later can be selected the next time a group member
Projects in nested subgroups are not included in the template list.
creates a new project.
## 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
```
plaintext
# GitLab instance and group
# GitLab instance and group
gitlab.com/
acmeco
/
gitlab.com/
myorganization
/
# Subgroups
# Subgroups
internal
internal
tools
tools
...
@@ -61,7 +61,7 @@ gitlab.com/acmeco/
...
@@ -61,7 +61,7 @@ gitlab.com/acmeco/
# Project templates
# Project templates
client-site-django
client-site-django
client-site-gatsby
client-site-gatsby
client-site-h
TML
client-site-h
tml
# Other projects
# Other projects
client-site-a
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