The add-on I've written defines several custom hotkeys, allowing the user to call custom menus created by the add-on. To be more user-friendly, I'd like to make it easy for the user to change the hotkeys for these menus without needing to dig through the massive keymap list under User Preferences > Input.

And so I have created AddonPreferences, in which the user can adjust settings for the add-on.

Is there a way to pull in, and draw the specific keymap item (from Input) within the AddonPreferences?


1 Answer 1


You're likely the first person who has attempted this, and it looks like its quite possible;


  • Save this script to your addons dir with a unique name (ending with .py)
  • The keymaps are added as is normal for an addon.
  • There is one bug at the moment, pressing the 'X' buttons isn't properly removing them. (needs further investigation we should be able to fix)
  • Finally - this uses a part of the API we consider internal, so its not guaranteed to work in future versions (realistically it probably wont change any time soon though).


bl_info = {"name": "KeyMap Test", "category": "Object"}

import bpy
from bpy.types import Operator, AddonPreferences
from bpy.props import StringProperty, IntProperty, BoolProperty

# this is an internal API at the moment
import rna_keymap_ui

class ExampleAddonPreferences(AddonPreferences):
    # this must match the addon name, use '__package__'
    # when defining this in a submodule of a python package.
    bl_idname = __name__

    filepath = StringProperty(
            name="Example File Path",
    number = IntProperty(
            name="Example Number",
    boolean = BoolProperty(
            name="Example Boolean",

    def draw(self, context):
        layout = self.layout
        layout.label(text="This is a preferences view for our addon")
        layout.prop(self, "filepath")
        row = layout.row()
        row.prop(self, "number")
        row.prop(self, "boolean")

        col = layout.column()
        kc = bpy.context.window_manager.keyconfigs.addon
        for km, kmi in addon_keymaps:
            km = km.active()
            col.context_pointer_set("keymap", km)
            rna_keymap_ui.draw_kmi([], kc, km, kmi, col, 0)

class OBJECT_OT_addon_prefs_example(Operator):
    """Display example preferences"""
    bl_idname = "object.addon_prefs_example"
    bl_label = "Addon Preferences Example"
    bl_options = {'REGISTER', 'UNDO'}

    def execute(self, context):
        user_preferences = context.user_preferences
        addon_prefs = user_preferences.addons[__name__].preferences

        info = ("Path: %s, Number: %d, Boolean %r" %
                (addon_prefs.filepath, addon_prefs.number, addon_prefs.boolean))

        self.report({'INFO'}, info)

        return {'FINISHED'}

addon_keymaps = []

# Registration
def register():

    # Keymapping
    kc = bpy.context.window_manager.keyconfigs.addon
    km = kc.keymaps.new(name="3D View", space_type='VIEW_3D')
    kmi = km.keymap_items.new("object.editmode_toggle", 'NUMPAD_SLASH', 'PRESS', shift=True)
    kmi.active = True
    addon_keymaps.append((km, kmi))
    kmi = km.keymap_items.new("object.transform_apply", 'NUMPAD_SLASH', 'PRESS', shift=True)
    kmi.active = True
    addon_keymaps.append((km, kmi))

def unregister():

    # handle the keymap
    for km, kmi in addon_keymaps:
  • 1
    $\begingroup$ This is exactly what I need! Thanks so much. $\endgroup$ Jun 29, 2013 at 3:44
  • $\begingroup$ With the recent API changes, that are so far undocumentated, how can I go about this? $\endgroup$ Aug 19, 2013 at 23:57
  • $\begingroup$ Updated, only very minor changes, see rna_keymap_ui use. $\endgroup$
    – ideasman42
    Aug 20, 2013 at 2:51
  • 3
    $\begingroup$ In Blender 2.8 the keymaps are not persisted when doing it this way. Any ideas? $\endgroup$
    – Jayanam
    Jan 18, 2019 at 21:21
  • $\begingroup$ Another useful source. $\endgroup$ Oct 30, 2020 at 23:42

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .