actions/Configure GitHub Pages
A GitHub Action to enable Pages, extract various metadata about a site, and configure some supported static site generators.
View on GitHubTrust Signals
- Scorecard Score
- Scorecard 6–8scored Jul 6, 2026
- Maintenance Recency
- Activelast commit Mar 24, 2026
- License
- MIT
Pinned Snippet
uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| static_site_generator | Optional static site generator to attempt to configure: "nuxt", "next", "gatsby", or "sveltekit" | no | — |
| generator_config_file | Optional file path to static site generator configuration file | no | — |
| token | GitHub token | yes | ${{ github.token }} |
| enablement | Try to enable Pages for the repository if it is not already enabled. This option requires a token other than `GITHUB_TOKEN` to be provided. In the context of a Personal Access Token, the `repo` scope or Pages write permission is required. In the context of a GitHub App, the `administration:write` and `pages:write` permissions are required. | no | false |
Outputs
| name | description |
|---|---|
| base_url | GitHub Pages site full base URL. Examples: "https://octocat.github.io/my-repo", "https://octocat.github.io", "https://www.example.com" |
| origin | GitHub Pages site origin. Examples: "https://octocat.github.io", "https://www.example.com" |
| host | GitHub Pages site host. Examples: "octocat.github.io", "www.example.com" |
| base_path | GitHub Pages site full base path. Examples: "/my-repo" or "" |