Properties are how blender stores data. They are what you see in the interface with text or number inputs, checkboxes and dropdowns.

Properties will be saved with your blend file. If you just need a way to temporarily store data or need something like lists look at the variables section.

With Serpens you can create your own properties.

For a general introduction to blend data and properties that already exist in blender go here.

To create properties go to the Serpens N-Panel.

Attaching Properties

All properties that you create need to be attached to a specific type of data.

This is best to understand by thinking about existing blender properties. An objects name is a string property. This string property is attached to the object. It will be added for every object that you create and can be edited independently for every object.

The same is true for other types of data like images, scenes or materials. You can select what type of data your property should be attached to in the property settings when you create it. You will notice that only certain data types are available here. This is a blender limitation.

When you create a property attached to Material, every material in your file will have that property and you can get and set the property independently for each one.

By default properties are attached to the Scene. This is common for things like general addon settings as those should be set for your entire file.

Property Settings

There’s a few settings that every or almost every property type has.

This includes the data it is attached to which is explained above.

There’s also options that you can enable. Most of these are only applicable to certain property types or in operator properties (see Node Properties below).

For some properties you can set the subtype which just changes the way your property is displayed.

Some properties also have a default value.

Untitled

Property Types

String

A string property stores text. It will be displayed as a text input field.

Its subtypes can be used to display a file or directory path input. You can also create a password field.

Boolean

A boolean property stores a value of either True or False. It will be displayed as a checkbox or a toggle button.