What collaborators can do and how their changes are committed.

What collaborators are

Collaborators are invited by email.

Use them when someone needs to edit content or media but does not have a GitHub account.

What collaborators can do

Collaborators can:

  • open repositories they were invited to,
  • edit content,
  • edit media.

What collaborators cannot do

Collaborators cannot:

  • manage .pages.yml,
  • manage collaborators,
  • access cache admin features.

Those actions stay limited to GitHub users with repository access.

How collaborator commits work

Collaborator writes use the GitHub App installation token for the target repository.

By default, Pages CMS does not send the collaborator's name and email as committer metadata.

That means:

  • the write is authorized by the GitHub App,
  • the commit uses the authenticated app/installation identity unless commit identity is explicitly set to user.

If you want collaborator writes to include the collaborator's name and email as committer metadata, set settings.commit.identity: user or override a specific schema with commit.identity: user.

Migration

Collaborators live in the database, not in .pages.yml.

If you move to a new Pages CMS install, export and import collaborators separately.