2020-07-20 17:09:23 -04:00
---
stage: Create
group: Ecosystem
2020-11-26 01:09:20 -05:00
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2020-07-20 17:09:23 -04:00
---
2021-02-17 13:09:19 -05:00
# Service templates **(FREE)**
2017-02-03 13:41:35 -05:00
2021-02-11 19:09:00 -05:00
WARNING:
Service templates are [deprecated and scheduled to be removed ](https://gitlab.com/gitlab-org/gitlab/-/issues/268032 )
in GitLab 14.0. Use [project integration management ](#central-administration-of-project-integrations ) instead.
2020-10-14 20:08:42 -04:00
Using a service template, GitLab administrators can:
2020-07-16 20:09:37 -04:00
2020-10-14 20:08:42 -04:00
- Provide default values for configuring integrations when creating new projects.
- Bulk configure all existing projects in one step.
2020-07-16 20:09:37 -04:00
2020-10-14 20:08:42 -04:00
When you enable a service template:
- The defaults are applied to **all** existing projects that either:
- Don't already have the integration enabled.
- Don't have custom values stored for already enabled integrations.
- Values are populated on each project's configuration page for the applicable
integration.
- Settings are stored at the project level.
If you disable the template:
- GitLab default values again become the default values for integrations on
new projects.
2020-12-01 13:09:42 -05:00
- Projects previously configured using the template continue to use those settings.
2020-10-14 20:08:42 -04:00
If you change the template, the revised values are applied to new projects. This feature
does not provide central administration of integration settings.
## Central administration of project integrations
A new set of features is being introduced in GitLab to provide more control over
2021-04-06 11:09:23 -04:00
how integrations are configured at the instance, group, and project level. For
more information, read more about:
2020-10-14 20:08:42 -04:00
2021-04-06 11:09:23 -04:00
- [Setting up project integration management ](../../admin_area/settings/project_integration_management.md ) (introduced in GitLab 13.3)
- [Our plans for managing integrations ](https://gitlab.com/groups/gitlab-org/-/epics/2137 ).
2017-02-03 13:41:35 -05:00
2017-02-16 08:05:51 -05:00
## Enable a service template
2017-02-03 13:41:35 -05:00
2020-01-08 19:07:40 -05:00
Navigate to the **Admin Area > Service Templates** and choose the service
template you wish to create.
2017-02-03 13:41:35 -05:00
2020-10-14 20:08:42 -04:00
Recommendation:
- Test the settings on some projects individually before enabling a template.
- Copy the working settings from a project to the template.
There is no "Test settings" option when enabling templates. If the settings do not work,
2020-12-01 13:09:42 -05:00
these incorrect settings are applied to all existing projects that do not already have
2020-10-14 20:08:42 -04:00
the integration configured. Fixing the integration then needs to be done project-by-project.
2020-07-16 20:09:37 -04:00
## Service for external issue trackers
2017-02-16 08:05:51 -05:00
2020-07-16 20:09:37 -04:00
The following image shows an example service template for Redmine.
2017-02-03 13:41:35 -05:00
2020-12-01 13:09:42 -05:00
For each project, you still need to configure the issue tracking
2017-02-03 13:41:35 -05:00
URLs by replacing `:issues_tracker_id` in the above screenshot with the ID used
2020-07-16 20:09:37 -04:00
by your external issue tracker.
