---
title: Object Contents
description: "Use object content to add content information to objects in your scenes or speakers in a schematic. Object contents are found in **Content > Object Contents**. The information can be displayed by HUDs or used in dialogues. You can also change…"
url: "https://orkframework.com/guide/ork4/ork4-documentation/section-content/object-contents/"
updated: "2026-08-03"
category: "ORK 4 Documentation / Section: Content"
---

# Object Contents

Use object content to add content information to objects in your scenes or speakers in a schematic.

Object contents are found in **Content > Object Contents**.

The information can be displayed by HUDs or used in dialogues. You can also change the cursor when it's above an object.

Add an object content to an object in your scene using the *Object Content* component.

[![](https://orkframework.com/wp-content/uploads/ObjectContentComponent-Icon.png)](https://orkframework.com/wp-content/uploads/ObjectContentComponent-Icon.png)

Object content can use [content types](https://orkframework.com/guide/ork4/ork4-documentation/section-content/content-types/) to organize them. You’ll mainly use them to filter object content in the editor based on their content type or add additional information to them.

# Object Contents

Object contents are used to add information to objects in your scenes using an *Object Content Component* or to a schematic's speaker in a dialogue.

## Base Settings

Optionally use a content type for the object content, block tooltips for objects using the object content or use object variables on the object for variable text codes used by the content's texts.

## Cursor Changes

Optionally change the cursor texture while the cursor is over an object with the object content attached.

This will overrule overrule the content type's cursor changes.

## Object Variables

Object contents can overrule their content type's object variables settings and automatically add *Object Variable* components to the objects they're added to.

[![](https://orkframework.com/wp-content/uploads/ObjectVariablesComponent-Icon.png)](https://orkframework.com/wp-content/uploads/ObjectVariablesComponent-Icon.png)

This also allows setting the *object ID* for the variables (or use them in local mode) and initialize default values.

## Portraits

You can add portraits to your object contents. Portraits can be shown by HUDs and dialogues.

An object content can overrule the portraits of it's content type by defining a portrait for the same organizer type.

## Custom Text Codes

Custom text codes can be used to add customizable information to the texts of object contents and content types (e.g. name or description), or dialogues that use a speaker.

# Object Content Component

Object content information can be added to objects in your scenes using a *Object Content Component*.

[![](https://orkframework.com/wp-content/uploads/ObjectContentComponent-Icon.png)](https://orkframework.com/wp-content/uploads/ObjectContentComponent-Icon.png)

Once that information is attached to the object, it can be used by different features, e.g.:

- *Interaction* HUDs can use the object content attached to the displayed interaction's object
- *Tooltip* HUDs can show tooltips for objects with an attached object content
- schematic speakers can use it in dialogues

You don't need to set up object content data for each object in your game that needs information - only for each object that needs different information.

Your game has *wooden* and *metal* doors. A scene contains 5 doors, 3 wooden and 2 metal doors.

You'll need 2 different object contents - one with the *wooden door* information (e.g. name *Wooden Door*) and one with the *metal door* information (e.g. name *Metal Door*).

As you can see in this example, all objects that share the same information can use the same content object. On the other hand, if you need individual information on objects, you need to set up individual object contents for them.

Your game has 3 unique NPCs named *Red*, *Green*, and *Blue*. You'll need to set up object contents for all 3 of them.

## Text Codes

You can add additional text codes to object content components.

The component's text codes will overrule text codes defined in object contents or conent types, i.e. defining the same text code with a different value will use the value from the component.

This can be used to individualize parts of the object content information.

Your game's doors from before (*wooden* and *metal*) display additional information about where they're leading to using text codes.

The *wooden door*'s name is *Wooden Door to <destination>* and the *metal door*'s name is *Metal Door to <destination>*.

The object content components adding the object content to objects in your scene add a text code for *<destination>*, defining the name of the destination. E.g. a wooden door with the *<destination>* text code *Inn* will display *Wooden Door to Inn*.
