EdgeDB 1.0 is launching on Feb 10th! Watch the live event.
Claim your ticket

Inheritance is a crucial aspect of schema modeling in EdgeDB. Schema items can extend one or more parent types. When extending, the child (subclass) inherits the definition of its parents (superclass).

You can declare abstract object types, properties, links, constraints, and annotations.

Object types can extend other object types. The extending type (AKA the subtype) inherits all links, properties, indexes, constraints, etc. from its supertypes.

abstract type Animal {
  property species -> str;

type Dog extending Animal {
  property breed -> str;

For details on querying polymorphic data, see EdgeQL > Select > Polymorphic queries.

Object types can extend more than one type — that’s called multiple inheritance. This mechanism allows building complex object types out of combinations of more basic types.

abstract type HasName {
  property first_name -> str;
  property last_name -> str;

abstract type Email {
  property email -> str;

type Person extending HasName, HasEmail {
  property profession -> str;

An object type can overload an inherited property or link. All overloaded declarations must be prefixed with the overloaded prefix to avoid unintentional overloads.

abstract type Person {
  property name -> str;
  multi link friends -> Person;

type Student extending Person {
  overloaded property name -> str {
    constraint exclusive;
  overloaded multi link friends -> Student;

Overloaded fields cannot generalize the associated type; it can only make it more specific by setting the type to a subtype of the original or adding additional constraints.

Properties can be concrete (the default) or abstract. Abstract properties are declared independent of a source or target, can contain annotations, and can be marked as readonly.

abstract property title_prop {
  annotation title := 'A title.';
  readonly := false;

Use abstract to declare reusable, user-defined constraint types.

abstract constraint in_range(min: anyreal, max: anyreal) {
  errmessage :=
    'Value must be in range [{min}, {max}].';
  using (max > __subject__ and __subject__ >= min);

type Player {
  property points -> int64 {
    constraint in_range(0, 100);

EdgeQL supports three annotations types by default: title, description, and deprecated. Use abstract annotation to declare custom user-defined annotation types.

abstract annotation admin_note;

type Status {
  annotation admin_note := 'system-critical';
  # more properties

By default, annotations defined on abstract types, properties, and links will not be inherited by their subtypes. To override this behavior, use the inheritable modifier.

abstract inheritable annotation admin_note;