Add ability to create tooltip descriptions for dynamically exported properties

[ryevdokimov]

Implements: godotengine/godot-proposals#8531

Example:

func _get_property_description(property: StringName) -> String:
	if property.begins_with("Light "):
		var index_str := property.trim_prefix("Light ")
		if index_str.is_valid_int():
			var index := index_str.to_int()
			if index == 1:
				return "Bottom segment of the stack light."
			elif index == segments:
				return "Top segment of the stack light."
			else:
				return "Middle segment %d of the stack light." % index
	return ""

2026-01-20.12-51-46.mp4

[Naros]

There should be a supplemental sibling PR that introduces this to Wrapped in godot-cpp.

[KoBeWi]

Looks like this can replace the functionality added in #85868
And I guess it's related to godotengine/godot-proposals#13965 (makes it possible to implement it, but without docs)

However using it in the engine requires binding a method, which is not ideal.

[Zehir]

I just tested (and look at the code) the changes, and it's working as expected. However, I would make some changes;

Documentation

Maybe it's worth mentioning in the documentation that the description supports BBCode ?

func _get_property_description(property: StringName) -> String:
	return "Sample description of [b]property[/b] '%s'" % property

Extend usage for category, group and subgroup

Also I was not able to add a description to property with usage PROPERTY_USAGE_CATEGORY, PROPERTY_USAGE_GROUP and PROPERTY_USAGE_SUBGROUP

	properties.append({
		"name": "Numbers",
		"type": TYPE_NIL,
		"hint_string": "number_",
		"usage": PROPERTY_USAGE_GROUP
	})

But I was able to add one for PROPERTY_HINT_GROUP_ENABLE

Context

Full Test Node script

@tool
extends Node
class_name TestNode

@export var number_count = 3:
	set(nc):
		number_count = nc
		numbers.resize(number_count)
		notify_property_list_changed()

var numbers = PackedInt32Array([0, 0, 0])

func _get_property_list():
	var properties: Array[Dictionary] = []

	properties.append({
		"name": "Numbers",
		"type": TYPE_NIL,
		"hint_string": "number_",
		"usage": PROPERTY_USAGE_GROUP
	})

	for i in range(number_count):
		properties.append({
			"name": "number_%d" % i,
			"type": TYPE_INT,
			"hint": PROPERTY_HINT_ENUM,
			"hint_string": "ZERO,ONE,TWO,THREE,FOUR,FIVE",
		})

	return properties

func _get(property):
	if property.begins_with("number_"):
		var index = property.get_slice("_", 1).to_int()
		return numbers[index]
	return null

func _set(property, value):
	if property.begins_with("number_"):
		var index = property.get_slice("_", 1).to_int()
		numbers[index] = value
		return true
	return false


func _get_property_description(property: StringName) -> String:
	return "Description for '%s'" % property

[ryevdokimov]

Suggestions applied.

[Zehir]

Tested the PR and it's working correctly, I was not able to break it in some wierd ways
The code looks good to me.

About groups this does works for ;

• PROPERTY_USAGE_GROUP
• PROPERTY_USAGE_SUBGROUP

But not for PROPERTY_USAGE_CATEGORY but I don't know if it's worth adding too ?

The _get_property_warning method don't display the warning for the group but it's currently been reworked in the PR #90049 and so I guess we can ignore it for this PR.

Next step team review I guess