#34818·backstage

Fails to set Group namespace from GitHub org when use customTeamTransformer

Author: apc-kamezakiCreated Jul 9, 2026Updated Sep 17, 2026
Labelstype:bugarea:catalogintegration:githubneeds:triage

Issue Labels

  • Please familiarize yourself with the issue labels used in this project: LABELS.md

Search Terms

plain
"transformer", "namespace", "githubOrg"

️ Project Area

Catalog

External Integration

GitHub

Description & Context

When a custom TeamTransformer is specified for GitHubOrgEntityProvider , the GitHub organization name is not set as the Group's namespace. Namespace of the group entity remained 'default'.

Expected Behavior

Even when configuring a custom team transformer, I believe the GitHub organization name should be used as the namespace for the group entity.

I think defaultMultiOrgTeamTransformer shoud be like this.

typescript
  private async defaultMultiOrgTeamTransformer(
    team: GithubTeam,
    ctx: TransformerContext,
  ): Promise<Entity | undefined> {
    const transformer = this.options.teamTransformer || defaultOrganizationTeamTransformer;
    const result = await transformer(team, ctx);

    if (result && result.spec) {
      if (!this.options.alwaysUseDefaultNamespace) {
        result.metadata.namespace = ctx.org.toLocaleLowerCase('en-US');
      }

      // Group `spec.members` inherits the namespace of it's group so need to explicitly specify refs here
      result.spec.members = team.members.map(
        user => `${DEFAULT_NAMESPACE}/${user.login}`,
      );
    }

    return result;
  }

Reproduction Repo

No response

Reproduction steps

No response

Have you read the Code of Conduct?

Are you willing to submit PR?

Yes, and I have enough information to get started