I'm starting to use the amazing, yet simple to use Blender Drivers:


I'm looking for a way to add other Types of Custom Properties than the default floats.

For instance: Color, Vector, String, Boolean or Integer.

From what I've seen it seems to rely on Python.


2 Answers 2


AFAIK you can set up all but boolean by using that type in the property value field. Eg type in integer 1 and you will notice the slider moves by integers, even if min and max are displayed as reals.

For vector floats, typing in (1.0, 0.0, 0.0, 0.0) gives a list usable for rgba values.

>>> C.scene['prop']
<bpy id property array [4]>

>>> C.object.color = C.scene['prop']

>>> [c for c in C.scene['prop']]
[1.0, 0.0, 0.0, 1.0]

To define them with a script is pretty simple too

import bpy
context = bpy.context
scene = context.scene
scene["someprop"] = False

To get a little more into it, the _RNA_UI is where custom properties keep their data, min, max, default, description

import bpy

context = bpy.context
obj = context.object

rna_ui = obj.get('_RNA_UI')
if rna_ui is None:
    obj['_RNA_UI'] = {}
    rna_ui = obj['_RNA_UI']

obj["prop"] = (1.0, 0.0, 0.0, 1.0)
obj["bool"] = 0

rna_ui["bool"] = {"description":"Bool",
                  "default": True,

rna_ui["prop"] = {"description": "Color Prop",
                  "default": (1.0, 0.0, 0.0, 0.0),
                  "min": 0.0,
                  "max": 1.0,

You can add these to your own layout

import bpy
from bpy.props import FloatVectorProperty, BoolProperty

class CarPanel(bpy.types.Panel):
    """Creates a Panel in the Object properties window"""
    bl_label = "Car Details"
    bl_idname = "OBJECT_PT_hello"
    bl_space_type = 'PROPERTIES'
    bl_region_type = 'WINDOW'
    bl_context = "object"

    def poll(cls, context):
        return context.object.get("Capot", False)

    def draw(self, context):
        layout = self.layout

        car = context.object
        layout.prop(car, '["Capot"]')
        #bools don't show well (1 or 0 integer)
        layout.prop(car, "switch")
        layout.prop(car, '["bool"]')
        col = layout.column()
        col.prop(car, '["prop"]')
        # car color property
        row = layout.row()
        row.prop(car, "car_color")
        # object color rgba
        row = layout.row()
        row.prop(car, "color")

def register():
    # define a registered property (available for all Object types size=4 gives rgba)
    bpy.types.Object.car_color = FloatVectorProperty(subtype='COLOR', size=3)
    bpy.types.Object.switch = BoolProperty()

def unregister():

if __name__ == "__main__":
  • $\begingroup$ Thanks. Really useful to me. I guess I was looking for a way to change the UI based on propierty: Boolean -> Tic Box; Array4 -> Color Picker. $\endgroup$
    – melMass
    Dec 28, 2015 at 13:22
  • $\begingroup$ NP, changed a little to show how to make a custom panel for your car. Any object that has a "Capot" custom prop will make the panel show (poll). Change to a more suitable prop. Panel is displayed in the object properties panel, but can be simply moved to 3D UI or Tool panels. Cool model, and drivers and custom props is a great way to "drive" it. $\endgroup$
    – batFINGER
    Dec 28, 2015 at 13:39
  • $\begingroup$ Thanks batFINGER, its pretty much it except the color value is represented as 4 sliders as opposed to a Color Picker. $\endgroup$
    – melMass
    Dec 29, 2015 at 12:16
  • $\begingroup$ To use the colorpicker you need to register a FloatVectorProperty subtype=color blender.org/api/blender_python_api_current/…, or use an existing color property (object or material). $\endgroup$
    – batFINGER
    Dec 29, 2015 at 12:35
  • $\begingroup$ @Akelian updated answer with registered props to show how to make a switch and use the color picker, either from the a defined prop, or using the object color. The registered props using XxxxProperty are available to all objects of that type (via obj.prop) , whereas ID properties are defined on a single object instance (via obj["prop"]) $\endgroup$
    – batFINGER
    Dec 29, 2015 at 12:48

In general press Add or Edit and whatever you type into the Property Value field will be used as the property type (with some exceptions**)

  • For Integer ID property:

    enter image description here

  • Float too.

    enter image description here

  • String, type in a word or a couple of words.

    enter image description here

  • The Boolean is really an Integer with two possible states, 0 and 1. You could limit a property by setting Min and Max to 0 and 1. A TickBox would be great for UI, but sadly this isn't available for ID props (not in a convenient way anyway). (Dec 2015)

  • For Array types (Color, Vector) there's currently not a convenient interface exposed by Custom Properties panel. By this I mean you can make a custom property by setting the value, by typing in (0,0,0) or [0,0,0] or even just 0,0,0

    enter image description here

    But you won't get a UI element like regular bpy.props

Id properties : http://wiki.blender.org/index.php/Dev:Source/Data_System/ID_Property


Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.