Document file template

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

  • Close this issue

Problem to solve

We have a hole in our docs here, for talking about file templates in general.

  • https://docs.gitlab.com/ee/user/admin_area/settings/instance_template_repository.html is about setting these templates at an INSTANCE level, and mentions gitignore files.
  • https://docs.gitlab.com/ee/user/group/manage.html#group-file-templates is for GROUP level templates.
  • https://docs.gitlab.com/ee/api/project_templates.html, https://docs.gitlab.com/ee/api/templates/gitignores.html, https://docs.gitlab.com/ee/api/templates/gitlab_ci_ymls.html, etc are API documentation.

The first two above are more for admins. The latter are for developers. There is no basic page for users that ties all these concepts together.

When you add a new file and type in the name of a template file you get additional options like, e.g. for .gitignore image. But you have to know that this is available.

For some file templates there is a button on the project main page but not on the repo->Files page: image

Further details

Proposal

  • Definitely fill this gap in the documentation (maintenance; this issue here)
  • Consider improving the discovery (feature; to be considered; create separate issue in case we want to do this)

Who can address the issue

Documentation team

Other links/references

Edited Oct 06, 2025 by 🤖 GitLab Bot 🤖
Assignee Loading
Time tracking Loading