Skip to content

Content

Supported Datatype

Represents a reference to asset content stored externally or as an object within the place.

Description

The Content data type represents a reference to asset content stored externally or as an object within the place, wrapping a single value of one of the supported ContentSourceType values.

Warning

Replication is not yet supported for Object values. When an Instance with a Content property containing a Object value is replicated, an unusable placeholder Object of the same type will be used instead of the Object itself, and any attempt to read or write the contents of that placeholder object will throw. These placeholder objects will render as a cyan and magenta checkerboard pattern.

This will be replaced with standard replication behavior in the future. For now, do not use EditableImage or EditableMesh as Content on the server on an Instance that can replicate to clients.

Constructors

fromUri Not yet Returns a new Content with an asset URI string value referencing content external to the place.
Content.fromUri(uri: string)

Returns a new Content with an asset URI string value referencing content external to the place.

Content.SourceType will be Uri, and Content.Uri will contain a non‑nil string value.

If uri is empty, Content.none will be returned instead.

fromAssetId Not yet Returns a new Content from a numeric asset ID.
Content.fromAssetId(assetId: number)

Returns a new Content from a numeric asset ID. This is a convenience constructor equivalent to calling Content.fromUri("rbxassetid://" .. tostring(assetId)).

Content.SourceType will be Uri, and Content.Uri will contain the formatted rbxassetid:// URI string.

If assetId is 0, Content.none will be returned instead.

Throws if assetId is non‑finite, for example math.huge() or 0/0.

fromObject Not yet Returns a new Content with a strong reference to an Object.
Content.fromObject(object: Object)

Returns a new Content with a strong reference to an Object.

Content.SourceType will be Object, and Content.Object will contain a non‑nil Object reference.

Content.Object references are strong references that hold shared ownership of the Object. Any Content.Object reference will extend the lifetime of that Object and prevent it from being garbage collected.

Throws if object is nil.

Constants

none Not yet An empty Content value with Content.SourceType of None.
Content.none()

An empty Content value with Content.SourceType of None.

Properties

none Not yet An empty Content value with Content.SourceType of None.
Content.none()

An empty Content value with Content.SourceType of None.

SourceType Not yet The source type of the contained value.
Content.SourceType()

The source type of the contained value. Indicates which property contains a non‑nil value.

Uri Not yet A URI string if Content.SourceType is Uri, otherwise nil.
Content.Uri()

A URI string if Content.SourceType is Uri, otherwise nil.

Object Not yet A reference to a non-nil Object if Content.SourceType is Object, otherwise nil.
Content.Object()

A reference to a non-nil Object if Content.SourceType is Object, otherwise nil.

Opaque Not yet A reference to a non-nil Opaque content if Content.SourceType is Opaque, otherwise nil.
Content.Opaque()

A reference to a non-nil Opaque content if Content.SourceType is Opaque, otherwise nil.

Roblox reference: Content