ueberdosis/tiptap · error

[tiptap error]: Extension "${name}" uses an unknown decorati

Error message

[tiptap error]: Extension "${name}" uses an unknown decoration update strategy. Expected "document", "changedRanges", or "manual".

What it means

Error "[tiptap error]: Extension "${name}" uses an unknown decoration update strategy. Expected "document", "changedRanges", or "manual"." thrown in ueberdosis/tiptap.

Source

Thrown at packages/core/src/decorations/helpers/validateDecorationSpec.ts:44

      }
      return
    case 'manual':
      if (spec.createInRange) {
        throw new Error(
          `[tiptap error]: Extension "${name}" uses the "manual" decoration update strategy, ` +
            'which is not compatible with createInRange(). createInRange() requires the ' +
            '"changedRanges" strategy.',
        )
      }
      if (spec.shouldUpdate) {
        throw new Error(
          `[tiptap error]: Extension "${name}" cannot combine the "manual" decoration update ` +
            'strategy with shouldUpdate().',
        )
      }
      return
    default:
      throw new Error(
        `[tiptap error]: Extension "${name}" uses an unknown decoration update strategy. ` +
          'Expected "document", "changedRanges", or "manual".',
      )
  }
}

View on GitHub (pinned to 496d53afd7)

When it happens

Trigger: Thrown at packages/core/src/decorations/helpers/validateDecorationSpec.ts:44 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ueberdosis/tiptap@496d53afd7 (2026-08-26). Data as JSON: /api/errors/0ab218bd34054a65. Report an issue: GitHub.