| mode | Use publish for GitHub to WordPress, propose for WordPress pull requests, or reconcile for safe two-way synchronization. | no | publish |
| wordpress-url | WordPress API base URL. Use https://public-api.wordpress.com for WordPress.com. | no | https://public-api.wordpress.com |
| wordpress-site | WordPress.com site ID or domain. Required for WordPress.com API mode. | yes | — |
| wordpress-access-token | OAuth bearer token with permission to edit pages on the target WordPress site. | yes | — |
| docs-dir | Directory containing Markdown docs. | no | docs |
| manifest-file | Optional JSON manifest that defines page order, slugs, parents, titles, and Markdown sources. | no | "" |
| redirects-file | Optional JSON map of old docs paths to new docs paths or external URLs. Creates managed moved-page placeholders. | no | "" |
| root-slug | Slug for the managed root page. | no | docs |
| root-title | Title for the managed root page when no root index document supplies one. | no | Docs |
| create-h1 | Add the page title as an H1 block at the top of generated WordPress content. | no | false |
| rewrite-links | Rewrite local Markdown links to the generated WordPress page URLs. | no | true |
| edit-link | Append an Edit this page on GitHub link to synced Markdown-backed pages. | no | false |
| edit-link-text | Link text for appended source links when edit-link is enabled. | no | Edit this page on GitHub |
| github-repository | GitHub repository for edit links, such as owner/repo. Defaults to GITHUB_REPOSITORY. | no | "" |
| github-ref | GitHub branch or ref for edit links. Defaults to GITHUB_REF_NAME. | no | "" |
| github-server-url | GitHub server URL for edit links. Defaults to GITHUB_SERVER_URL. | no | "" |
| github-token | GitHub token used to create or update reverse-sync branches and pull requests. | no | ${{ github.token }} |
| pull-request-base | Base branch for WordPress-to-GitHub pull requests. Defaults to the repository default branch. | no | "" |
| pull-request-branch | Dedicated branch maintained by Docspress for WordPress-to-GitHub changes. | no | docspress/wordpress-sync |
| pull-request-title | Optional pull request and commit title override. Defaults to a conventional docs(scope) title derived from the changed Markdown files. | no | "" |
| status | WordPress status for created or updated pages, such as draft or publish. | no | publish |
| delete-mode | Use trash to move removed docs to Trash, or force to permanently delete them. | no | trash |
| dry-run | Plan WordPress and GitHub operations without writing to either system. | no | false |