# Sending custom properties with Character data from ConvAI to Unreal

**URL:** https://forum.convai.com/t/sending-custom-properties-with-character-data-from-convai-to-unreal/6309
**Category:** Unreal Engine Plugin
**Tags:** character-setup
**Created:** [June 11, 2026, 7:31am UTC](https://forum.convai.com/t/sending-custom-properties-with-character-data-from-convai-to-unreal/6309 "2026-06-11T07:31:48Z")
**Posts on this page:** 5
**Page:** 1

<div class="post-metadata">

### Author: ![marco.alting](https://avatars.discourse-cdn.com/v4/letter/m/85e7bf/32.png) [@marco.alting](https://forum.convai.com/u/marco.alting)
#### Post date: [June 11, 2026, 7:31am UTC](https://forum.convai.com/t/sending-custom-properties-with-character-data-from-convai-to-unreal/6309/1 "2026-06-11T07:31:48Z")

</div>

### What do you need help with?

Question

### Installation method

Manual installation / GitHub

### Issue area

Character Setup

### Impact

Minor - small issue or improvement

### Unreal Engine version

5.7

### Convai Unreal Engine Plugin version

4.0.0-beta.21

### Project setup

Blueprint

### Target platform

Unreal Editor

### Where does it happen?

Not tested yet

### Short summary

I want to be able to dynamically select a MetaHuman based the character I choose

### What happened?

Nothing yet, I don’t think the feature exists yet.

### What did you expect?

I would like to be able to link my ConvAI character to multiple MetaHumans in my Unreal app. But I don’t want to author the app when adding a new character on ConvAI.  
So, ideally the should be a property for the character where I could add multiple tags that correspond to my MetaHumans in the app, so users can add new characters without having to update the Unreal app for it.

If there is already a way to send extra data with the character, can you tell me how to use it?

### I checked the relevant documentation, resources, and similar forum posts before posting.

on

### I confirm that I did not include API keys, tokens, passwords, secrets, private character data, private conversation logs, or customer data.

on

---

<div class="post-metadata">

### Author: ![K3](https://yyz2.discourse-cdn.com/flex004/user_avatar/forum.convai.com/k3/32/2611_2.png) [@K3](https://forum.convai.com/u/K3)
#### Post date: [June 11, 2026, 8:03pm UTC](https://forum.convai.com/t/sending-custom-properties-with-character-data-from-convai-to-unreal/6309/2 "2026-06-11T20:03:18Z")

</div>

You can use the **Character List API** to retrieve the available character IDs:

> **[Character List API | Convai Documentation](https://docs.convai.com/api-docs/api-reference/core-api-reference/character-crafting-apis/character-list-api)**
>
> API to retrieve the list of characters, created by a user.

Then, in Unreal Engine, you can set the **Character ID** field on the **ConvaiChatBot** component to whichever character ID you want to use.

---

<div class="post-metadata">

### Author: ![marco.alting](https://avatars.discourse-cdn.com/v4/letter/m/85e7bf/32.png) [@marco.alting](https://forum.convai.com/u/marco.alting)
#### Post date: [June 12, 2026, 6:53am UTC](https://forum.convai.com/t/sending-custom-properties-with-character-data-from-convai-to-unreal/6309/3 "2026-06-12T06:53:52Z")

</div>

Thanks for the reply, but that is not what I mean.

I understand the default API methods and the variable and values they return, but the character ID will not help me.

I’m already getting the list of characters, so I have the ID’s. But in my Unreal app I have multiple MetaHuman “heads” that I want to be able to choose from when select one of the character ID’s. I need to be able link one or multiple of those heads to a ConvAI character from the ConvAI side, so I don’t have to constantly author the link between a character and the heads that can be used.  
So I was hoping I could set something like an array of “head” strings on the ConvAI side, that will be sent with the response when calling the list of Characters with the API.

So any field I could use on the ConvAI side on the character API that I can send with the list API call would be great for this.

If not, I was thinking of adding something like [head1, head2, head4] to the start of the description of the character and parse that when parsing the results of the API response. But that is kind of ugly and might also polute the AI prompt, since that will be reading the description as well.

I hope there’s something I can use.

---

<div class="post-metadata">

### Author: ![K3](https://yyz2.discourse-cdn.com/flex004/user_avatar/forum.convai.com/k3/32/2611_2.png) [@K3](https://forum.convai.com/u/K3)
#### Post date: [June 15, 2026, 2:04pm UTC](https://forum.convai.com/t/sending-custom-properties-with-character-data-from-convai-to-unreal/6309/6 "2026-06-15T14:04:26Z")

</div>

At the moment, we do not support this use case directly.

---

<div class="post-metadata">

### Author: ![system](https://canada1.discourse-cdn.com/flex004/uploads/convai/original/1X/e60ef96aa7334c5ccf6682f6c6dbc20fcfa96b49.png) [@system](https://forum.convai.com/u/system)
#### Post date: [June 22, 2026, 8:45am UTC](https://forum.convai.com/t/sending-custom-properties-with-character-data-from-convai-to-unreal/6309/7 "2026-06-22T08:45:48Z")

</div>

This topic was automatically closed 3 days after the last reply. New replies are no longer allowed.
