Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub

@alexjorgef/gatsby-source-gitlab

Source playlists from GitLab into Gatsby.

Install

npm install @alexjorgef/gatsby-source-gitlab

How to use

Add the plugin to your gatsby-config file:

gatsby-config.js
module.exports = {
  plugins: [
    {
      resolve: `@alexjorgef/gatsby-source-gitlab`,
      options: {}
    }
  ]
}

Plugin Options

accessToken (required)

The GitLab API access token used for authentication.

Field type: string

{
  resolve: `@alexjorgef/gatsby-source-gitlab`,
  options: {
    accessToken: `glpat-xxxxxxxxxxxxxxxxxxxxx`,
  },
}

queries (required)

List of search queries to execute against the GitLab API.

Field type: string[]

{
  resolve: `@alexjorgef/gatsby-source-gitlab`,
  options: {
    queries: [
      `{
        repository(owner: "torvalds", name: "linux") {
          name
          url
        }
      }`,
      `{
        repository(owner: "gatsbyjs", name: "gatsby") {
          name
          url
          stargazerCount
        }
      }`,
    ]
  },
}

apiUrl (optional)

The GitLab API URL to use.

Field type: string

{
  resolve: `@alexjorgef/gatsby-source-gitlab`,
  options: {
    apiUrl: `https://gitlab.com/api/graphql`,
  },
}
© 2026 Gatsby, Inc.