Create a GitLab Pages website from a project template
{{< details >}}
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
{{< /details >}}
GitLab provides templates for the most popular Static Site Generators (SSGs). You can create a new project from a template and run the CI/CD pipeline to generate a Pages website.
Use a template when you want to test GitLab Pages or start a new project that’s already configured to generate a Pages site.
- On the left sidebar, at the top, select Create new ({{< icon name=”plus” >}}) and New project/repository.
- Select Create from Template.
- Next to one of the templates starting with Pages, select Use template.
- Complete the form and select Create project.
- On the left sidebar, select Build > Pipelines and select New pipeline to trigger GitLab CI/CD to build and deploy your site.
When the pipeline is finished, go to Deploy > Pages to find the link to your Pages website.
For every change pushed to your repository, GitLab CI/CD runs a new pipeline that immediately publishes your changes to the Pages site.
To view the HTML and other assets that were created for the site, download the job artifacts.
Project templates
{{< history >}}
-
Removed the following templates from
project templates in GitLab 18.0:
Bridgetown,Gatsby,Hexo,Middleman,Netlify/GitBook,Netlify/Hexo,Netlify/Hugo,Netlify/Jekyll,Netlify/Plain HTML, andPelican.
{{< /history >}}
GitLab maintains template projects for these frameworks:
| Realm | Framework | Available project templates |
|---|---|---|
| Go | hugo
| Pages/Hugo |
| Markdown | astro
| Pages/Astro |
| Markdown | docusaurus
| Pages/Docusaurus |
| Plain HTML | plain-html
| Pages/Plain HTML |
| React | next.js
| Pages/Next.js |
| Ruby | jekyll
| Pages/Jekyll |
| Vue.js | nuxt
| Pages/Nuxt |