cube-js/cube · error

Can't resolve '${memberRef.member}' while generating include

Error message

Can't resolve '${memberRef.member}' while generating include members

What it means

While expanding a view's include members against the target cube, a member reference (a name or a cube-qualified path like CubeName.member) could not be resolved to any member of that cube. This is the generic sentinel guard of generateIncludeMembers: the member at fault is the one referenced in the view's includes list.

Source

Thrown at packages/cubejs-schema-compiler/src/compiler/CubeSymbols.ts:1079

    dimensionName: string
  ): { keyReference: string } {
    const viewKeyMember = viewAllMembers.find(v => v.member === keyReference);

    if (!viewKeyMember) {
      throw new UserError(
        `Dimension '${dimensionName}' has key '${keyReference}' but the key dimension is not included in view '${viewName}'`
      );
    }

    return { keyReference: `${viewName}.${viewKeyMember.name}` };
  }

  protected generateIncludeMembers(members: any[], type: string, targetCube: CubeDefinitionExtended, viewAllMembers: ViewResolvedMember[]) {
    return members.map(memberRef => {
      const path = memberRef.member.split('.');
      const resolvedMember = this.getResolvedMember(type, path[path.length - 2], path[path.length - 1]);
      if (!resolvedMember) {
        throw new Error(`Can't resolve '${memberRef.member}' while generating include members`);
      }

      let processedDrillMembers = resolvedMember.drillMembers;

      // We need to filter only included drillMembers for views
      if (type === 'measures' && resolvedMember.drillMembers && targetCube.isView) {
        const sourceCubeName = path[path.length - 2];

        const evaluatedDrillMembers = this.evaluateReferences(
          sourceCubeName,
          resolvedMember.drillMembers,
          { originalSorting: true }
        );

        const drillMembersArray = (Array.isArray(evaluatedDrillMembers)
          ? evaluatedDrillMembers
          : [evaluatedDrillMembers]);

View on GitHub (pinned to 7d981676b3)

Solutions

1. Check the spelling and case of the member name in the view's includes
2. Fully qualify the member as CubeName.memberName and verify that cube is joined to the view's cubes
3. Confirm the member exists in the target cube (it may have been renamed or removed)

When it happens

Trigger: Thrown at packages/cubejs-schema-compiler/src/compiler/CubeSymbols.ts:1079 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of cube-js/cube@7d981676b3 (2026-09-02). Data as JSON: /api/errors/be418b28296a2d2f. Report an issue: GitHub.