Property types

The following properties are available on nodes and relationships:

AliasProperty IntegerProperty
ArrayProperty JSONProperty
BooleanProperty RegexProperty
DateProperty StringProperty
DateTimeProperty UniqueIdProperty


Default values you may provide a default value to any property, this can also be a function or any callable:

from uuid import uuid4
my_id = StringProperty(unique_index=True, default=uuid4)

You may provide arguments as function or lambda:

my_datetime = DateTimeProperty(default=lambda:


You can specify a list of valid values for a StringProperty using the choices argument. The mapping’s values are supposed to be used when displaying information to users:

class Person(StructuredNode):
    SEXES = {'F': 'Female', 'M': 'Male', 'O': 'Other'}
    sex = StringProperty(required=True, choices=SEXES)

tim = Person(sex='M').save() # M
tim.get_sex_display() # 'Male'

The value’s validity will be checked both when saved and loaded from Neo4j.

Array Properties

Neo4j supports arrays as a property value, these are used with the ArrayProperty class. You may optionally provide a list element type as the first argument to ArrayProperty with another property instance:

class Person(StructuredNode):
    names = ArrayProperty(StringProperty(), required=True)

bob = Person(names=['bob', 'rob', 'robert']).save()

In this example each element in the list is deflated to a string prior to being persisted.

Unique Identifiers

All nodes in neo4j have an internal id (accessible by the ‘id’ property in neomodel) however these should not be used by an application. neomodel provides the UniqueIdProperty to generate unique identifiers for your nodes (with an unique index):

class Person(StructuredNode):
    uid = UniqueIdProperty()


Dates and times

The DateTimeProperty accepts datetime.datetime objects of any timezone and stores them as a UTC epoch value. These epoch values are inflated to datetime.datetime objects with the UTC timezone set.

The DateProperty accepts objects which are stored as a string property ‘YYYY-MM-DD’.

You can use default_now argument to store the current time by default:

created = DateTimeProperty(default_now=True)

You can enforce timezones by setting the config var NEOMODEL_FORCE_TIMEZONE=1.

Other properties

  • EmailProperty - validate emails (via a regex).
  • RegexProperty - passing in a validator regex: RegexProperty(expression=r’dw’)
  • NormalProperty - use one method (normalize) to inflate and deflate.

Aliasing properties

Allows aliasing to other properties can be useful to provide ‘magic’ behaviour, (only supported on StructuredNodes):

class Person(StructuredNode):
    full_name = StringProperty(index=True)
    name = AliasProperty(to='full_name')

Person.nodes.filter(name='Jim') # just works

Independent database property name

You can specify an independent property name with ‘db_property’, which is used on database level. It behaves like Django’s ‘db_column’. This is useful for e.g. hiding graph properties behind a python property:

class Person(StructuredNode):
    name_ = StringProperty(db_property='name')

    def name(self):
        return self.name_.lower() if self.name_ else None

    def name(self, value):
        self.name_ = value