A `Logger` emits structured log entries that are tagged with a hierarchical
name, letting you group related messages by subsystem or feature. Obtain a
top-level logger from `Class.LogService:GetLogger()`, then create nested child
loggers with `Class.Logger:GetLogger()`. Each logger has a short
`Class.Logger.Name` and a dot-joined `Class.Logger.FullPath` built from its
ancestry (for example a logger named `Damage` created from a logger named
`Combat` has the full path `Combat.Damage`).

```lua
local LogService = game:GetService("LogService")

local combat = LogService:GetLogger("Combat")
local damage = combat:GetLogger("Damage")

print(damage.Name)      --> Damage
print(damage.FullPath)  --> Combat.Damage

damage:Info("Dealt {amount} damage to {target}", {amount = 25, target = "Goblin"})
```

Loggers behave the same as the structured logging methods on
`Class.LogService`: messages flow to the **Output** window, the Developer
Console, and `Class.LogService.MessageOut`, and are included in
`Class.LogService:GetLogHistory()` tagged with the logger's full path.

#### Hierarchy and Propagation

When a message is logged on a logger, its `Class.Logger.MessageOut` event
fires on that logger **and** on every ancestor up to the root. This lets you
attach a listener on a parent logger to observe all messages emitted by its
descendants. The message is emitted to the engine's output system exactly
once, tagged with the originating logger's full path.

#### Template Syntax and Context

The logging methods accept the same `{key}` template placeholders and
`context` tables as the structured logging methods on `Class.LogService`. See
`Class.LogService` for details on template syntax and how context values are
stored.

#### Lifetime

A logger remains valid as long as you hold a reference to it. Once all
references to a logger (and its descendants) are released, it is reclaimed,
and calling any method on a stale logger raises an error. The number of live
loggers and the length of a logger's full path are both bounded; exceeding
either limit raises an error from `Class.Logger:GetLogger()`.

#### Warning

This class might have unexpected or unreliable behavior and content might be
truncated. Don't rely on contents of events and messages emitted by loggers
for any important game logic.


Fires whenever a message is logged through this logger or any logger
beneath it in the hierarchy. Because a logged message fires `MessageOut`
on the originating logger and each of its ancestors, a listener attached
to a parent logger observes every message emitted by its descendants. The
`message` parameter contains the fully rendered text (template
placeholders already replaced), and the `context` parameter carries the
structured key-value pairs when the message was logged with a context
table; otherwise it is nil.

```lua
local LogService = game:GetService("LogService")
local combat = LogService:GetLogger("Combat")

combat.MessageOut:Connect(function(message, messageType, context)
	print("[Combat]", message)
end)

-- A message logged on a descendant also fires the parent's MessageOut.
combat:GetLogger("Damage"):Info("Hit for {amount}", {amount = 10})
-- Prints: [Combat] Hit for 10
```


Logger.MessageOut

message

The fully rendered message string after any template placeholder
substitution.


messageType

A `Enum.MessageType` value indicating the severity level of the
message.


context

A dictionary of key-value pairs provided when the message was logged,
or nil if no context was supplied.


Fires when a message is logged through this logger or any of its
descendants.


Returns the child logger with the given `name`, creating it if it does not
already exist. Calling this with the same name repeatedly returns the same
logger instance for as long as a reference to it is held. The returned
logger's `Class.Logger.FullPath` is this logger's full path followed by
`.` and `name`.

This method raises an error if the name is empty, contains a `.`, or
contains control characters, if the resulting full path is too long, or if
the maximum number of live loggers has been exceeded.

```lua
local LogService = game:GetService("LogService")

local network = LogService:GetLogger("Network")
local http = network:GetLogger("Http")

print(http.FullPath)  --> Network.Http
```


Logger:GetLogger

name

The name of the child logger. Must be non-empty, must not contain a
`.` character, and must not contain control characters.


The child `Class.Logger` whose full path is this logger's full path
followed by `.name`.


Returns a child logger with the given name, creating it if it does not
already exist.


Logs a message at the `Enum.MessageType.MessageOutput` level, tagged with
this logger's `Class.Logger.FullPath`. When a `context` table is provided,
template placeholders like `{key}` in the message are replaced with the
corresponding context values, and the context is preserved as structured
data for display in the Developer Console and Studio's **Output** window.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Shop")

logger:Output("Player {name} opened the shop", {name = "Alice"})
-- Output: "Player Alice opened the shop"
```


Logger:Output

The message string. Supports `{key}` template placeholders when a
context table is provided.


An optional dictionary of key-value pairs. When provided, `{key}`
placeholders in the message are replaced with the corresponding
values.


Logs a message at the `Enum.MessageType.MessageOutput` level with optional
structured context.


Logs a message at the `Enum.MessageType.MessageInfo` level, tagged with
this logger's `Class.Logger.FullPath`. When a `context` table is provided,
template placeholders like `{key}` in the message are replaced with the
corresponding context values.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Combat")

logger:Info("Dealt {amount} damage", {amount = 42})
-- Output: "Dealt 42 damage"
```


Logger:Info

Logs a message at the `Enum.MessageType.MessageInfo` level with optional
structured context.


Logs a message at the `Enum.MessageType.MessageWarning` level, tagged with
this logger's `Class.Logger.FullPath`. When a `context` table is provided,
template placeholders like `{key}` in the message are replaced with the
corresponding context values.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Combat")

logger:Warn("Health low: {hp}", {hp = 5})
-- Output: "Health low: 5"
```


Logger:Warn

Logs a message at the `Enum.MessageType.MessageWarning` level with
optional structured context.


Logs a message at the `Enum.MessageType.MessageError` level, tagged with
this logger's `Class.Logger.FullPath`. Unlike `Class.LogService:Error()`,
this method emits an error-level log entry and returns normally; it does
**not** throw. When a `context` table is provided, template placeholders
like `{key}` in the message are replaced with the corresponding context
values.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Network")

logger:Error("Request failed: {reason}", {reason = "timeout"})
-- Emits an error-level log; execution continues.
```


Logger:Error

Logs a message at the `Enum.MessageType.MessageError` level with optional
structured context.


Logs a message at the specified `Enum.MessageType` level, tagged with this
logger's `Class.Logger.FullPath`. This is a general-purpose method that
combines `Class.Logger:Output()|Output()`, `Class.Logger:Info()|Info()`,
`Class.Logger:Warn()|Warn()`, and `Class.Logger:Error()|Error()` into a
single call with an explicit message type parameter. Unlike
`Class.LogService:Log()`, passing `Enum.MessageType.MessageError` emits an
error-level log and returns normally rather than throwing.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Combat")

logger:Log(Enum.MessageType.MessageInfo, "Event {action}", {action = "spawn"})
```


Logger:Log

The `Enum.MessageType` specifying the log level.


Logs a message at the specified level with optional structured context.


Logger

The name of this logger as supplied to `Class.LogService:GetLogger()` or
`Class.Logger:GetLogger()`. This is a single path segment and never
contains a `.` character. Use `Class.Logger.FullPath` for the complete
dot-joined path.


Logger.Name

The name segment of this logger within its parent.


The full path of this logger, formed by joining the `Class.Logger.Name` of
each logger from the root down to this one with `.` separators. For a
top-level logger the full path equals its name. Messages logged through
this logger are tagged with this full path in
`Class.LogService:GetLogHistory()`.


Logger.FullPath

The dot-joined path of this logger from the root logger.


A named logger that emits structured log entries scoped to a hierarchical
path.


`Object` is the base class for all classes in the Roblox class hierarchy.
Every other class that the Roblox Engine defines inherits all of the members
of `Object`. It is not possible to directly create an `Object`.


This sample demonstrates the subtleties of the `Changed` event on normal
objects and `Value` objects.


This code sample demonstrates the Changed event firing within a parent object.


This event fires immediately after an object property is changed, with
some exceptions (see below). The new value of a changed property is
**not** passed as a parameter. Instead, you can access it using
`object[property]`:

```
object.Changed:Connect(function(property)
	print("The new property's value is", object[property])
end)
```

- If you are only interested in listening for changes to one specific
  property, consider using the
  `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`
  method instead.
- To listen for changes in attributes, see
  `Class.Instance:GetAttributeChangedSignal()` and
  `Class.Instance.AttributeChanged`.
- To detect when children are added or removed, see
  `Class.Instance.ChildAdded` and `Class.Instance.ChildRemoved`.

For `Class.ValueBase` objects such as `Class.IntValue` and
`Class.StringValue`, this event only fires when the object's `Value`
property changes. To detect other changes in `Class.ValueBase` objects,
use `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`.

#### Limitations

This event does **not** fire for physics-related changes, such as when the
`Class.BasePart.CFrame|CFrame`,
`Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity`,
`Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`,
`Class.BasePart.Position|Position`, or
`Class.BasePart.Orientation|Orientation` properties of a `Class.BasePart`
change due to gravity. To detect changes in these properties, consider
using a physics-based event like `Class.RunService.PreSimulation`.
Similarly, the `Changed` event does not fire when
`Class.BasePart.AssemblyMass|AssemblyMass` updates due to a change in
material, size, or density for a welded part (but the event does fire for
`Class.BasePart.Mass|Mass` if you modify a part's size).

For properties that change frequently, the `Changed` event might not fire
for every modification, or it might not fire at all. **If a property
change impacts your game logic, test carefully** to ensure the event is
firing as you expect.


Object.Changed

property

Fires immediately after a property of the object changes, with some
limitations.


This code sample demonstrates how to save a value before a changed event fires
on it in order to get more information about a change.


This code sample demonstrates the equivalence of the `Changed` event and event
returned by `GetPropertyChangedSignal`.


This method returns an event that behaves exactly like the
`Class.Object.Changed|Changed` event, except that it only fires when the
given property changes. It's generally a good idea to use this method
instead of a connection to `Class.Object.Changed|Changed` with a function
that checks the property name. Subsequent calls to this method on the same
object with the same property name return the same event.

`Class.ValueBase` objects, such as `Class.IntValue` and
`Class.StringValue`, use a modified `Class.Object.Changed|Changed` event
that fires with the contents of their `Value` property. As such, this
method provides a way to detect changes in other properties of those
objects.

Note that this event will not pass any arguments to a connected function,
so the value of the changed property must be read directly within a
script.

#### Limitations

The event returned by this method does **not** fire for physics-related
changes, such as when the `Class.BasePart.CFrame|CFrame`,
`Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity`,
`Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`,
`Class.BasePart.Position|Position`, or
`Class.BasePart.Orientation|Orientation` properties of a `Class.BasePart`
change due to gravity. To detect changes in these properties, consider
using a physics-based event like `Class.RunService.PreSimulation`.

Additionally, the returned event may not fire on every modification of
properties that change very frequently, and/or it may not fire for such
properties at all. It's recommended that you carefully test for property
changes that impact game logic.


Object:GetPropertyChangedSignal

A signal that fires whenever the property changes.


Get an event that fires when a given property of the object changes.


Demonstrates determining the class of Workspace using `Class.Instance:IsA()`

Workspace is of class 'Workspace', so the first statement is true. Workspace
is not of class 'BasePart', so the second statement is false. Workspace
inherits from Instance and therefore is of class 'Instance', so the third
statement is true.


IsA returns true if the object's class is **equivalent to** or a
**subclass** of a given class. This function is similar to the
**instanceof** operators in other languages, and is a form of
[type introspection](https://en.wikipedia.org/wiki/Type_introspection). To
ignore class inheritance, test the `Class.Object.ClassName|ClassName`
property directly instead. For checking native Luau data types (number,
string, etc) use the functions `type` and `typeof`.

Most commonly, this function is used to test if an object is some kind of
part, such as `Class.Part` or `Class.WedgePart`, which inherits from
`Class.BasePart` (an abstract class). For example, if your goal is to
change all of a character's limbs to the same color, you might use
`Class.Instance:GetChildren()|GetChildren` to iterate over the children,
then use IsA to filter non-`Class.BasePart` objects which lack the
`Datatype.BrickColor` property:

```lua
local Players = game:GetService("Players")

local function paintFigure(character, color)
	-- Iterate over the child objects of the character
	for _, child in character:GetChildren() do
		-- Filter out non-part objects, such as Shirt, Pants and Humanoid
		-- R15 use MeshPart and R6 use Part, so we use BasePart here to detect both:
		if child:IsA("BasePart") then
			child.BrickColor = color
		end
	end
end
paintFigure(Players.Player.Character, BrickColor.new("Bright blue"))
```

Since all classes inherit from `Class.Object`, calling
`object:IsA("Object")` will always return true.


Object:IsA

className

The class against which the Object's class will be checked.
Case-sensitive.


Describes whether the Object's class matched or is a subclass of the
given class.


Returns true if an object's class matches or inherits from a given class.


Object:isA

Object

A read-only string representing the class this `Class.Object` belongs to.

This property can be used with various other functions that are used to
identify objects by type, such as `Class.Object:IsA()` or
`Class.Instance:FindFirstChildOfClass()`.

Note this property is read only and cannot be altered by scripts.
Developers wishing to change an object's class will instead have to create
a new `Class.Object`.

Unlike `Class.Object:IsA()`, ClassName can be used to check if an object
belongs to a specific class ignoring class inheritance. For example:


Object.ClassName

A read-only string representing the class this `Class.Object` belongs to.


Object.className

`Object` is the base class for all classes in the Roblox class hierarchy.


Luau

Dictionary

A named logger that emits structured log entries scoped to a hierarchical path.

Class

Enum

Enum.MessageType

An object that runs connected functions upon a specific occurrence.

Data Type

RBXScriptSignal

Data type having a value of either true or false.

boolean

A sequence of characters, such as letters, numbers, and symbols.

string

Experiences

Avatar

Assets

Samples and projects

Engine API

Open Cloud API

Studio

Analytics

Platform

Tutorials

Creator programs

Education

Learn

This method is asynchronous and returns an `Operation`, which represents the current state of the operation. It contains an endpoint path that you can poll to obtain the real response and applicable metadata. See the [documentation]({longRunningOperationsLink}) on long-running operations for more information.
            
The following sections describe the response and metadata objects that are provided when an operation completes.

Beta endpoints are ready for public use. Breaking changes are possible but rare.

These Open Cloud documentation pages will be removed on March 31, 2026. You will be automatically redirected to the new Open Cloud documentation at that time. {linkStart}Learn more{linkEnd}

These old Open Cloud pages will be removed and redirected on March 31, 2026. {linkStart}Learn more{linkEnd}

Experimental endpoints are ready for public use, but may experience breaking changes occasionally as the API contract is finalized.

This endpoint can be called in-experience through {httpServiceLinkStart}HttpService{httpServiceLinkEnd} with an API key.

This field may be set when creating a resource, but may not be modified by subsequent requests.

These fields may be set when creating a resource, but may not be modified by subsequent requests.

This field may be provided in requests, but will never be included in responses.

Legacy authentication method. Always prefer using API Key or OAuth 2.0 when available.

Per API Key: {maxInPeriod} requests every {periodInSeconds} seconds per IP Address

Requires no authentication to call. Typically has significantly lowered rate limits. Always prefer using API Key or OAuth 2.0 when available.

For each grouping, only one of the following fields in the schema has to be provided, the remaining can be excluded.

You can opt back in at any time. {linkStart}Provide feedback.{linkEnd}

You are viewing the old docs. {linkStart}Provide feedback.{linkEnd}

You can opt out at any time and be redirected back to the old reference pages. {linkStart}Provide feedback.{linkEnd}

You are viewing the revamped docs. {linkStart}Provide feedback.{linkEnd}

This field may be set on responses, but will be ignored in requests.

Note: Rate limits can be lower during high-traffic periods. Certain endpoints have additional rate limits. [Learn more about rate limits]({link}).

{limit} requests per day across all API keys for a user or group

{limit} requests per hour across all API keys for a user or group

{limit} requests per minute across all API keys for a user or group

{limit} requests per second across all API keys for a user or group

{limit} requests per minute per API key owner

{limit} request(s) per second per API key owner

Scopes control what permissions your credentials have. Your credentials can only access the endpoints supported by the scopes you selected.

Stable endpoints are production-ready and will almost never experience breaking changes during their lifetime.

This target enables you to limit your key's access to selected {requiredParts}

This target enables you to limit your key's access to selected {requiredParts} and {optionalParts}

Target types are used to restrict the resources that your credentials have permissions on. Only the selected resources can be acted on even if your account has permissions on additional resources. Some scopes do not have target parts. In these cases, all of your relevant resources can be acted on.

The universe Top Level Part does not need to be selected for user-owned API Keys. In this case, your API Key will have access to all of your user-owned experiences and group-owned experiences that you have the right group permissions on.

Try It Out is not yet supported for endpoints requiring API key or OAuth 2.0 authentication

Cookie authentication is disabled for high risk operations for safety.

Critical risk endpoints are extremely sensitive and Try It Out is disabled for safety

Note: Authentication headers are not included in this code sample. You may need to add an authentication header for this command to work.

This is a high risk endpoint that can modify or delete critical data. Use extreme caution when testing.

This API endpoint has been classified as HIGH RISK and may affect live data or user accounts.

Authenticated requests to high-risk APIs can make changes that cannot be undone. Please review your request parameters carefully before proceeding.

Please login to use cookie authentication

This is a low risk endpoint that retrieves data. This is generally safe to test.

This is a medium risk endpoint that modifies data. Test carefully with non-critical accounts, as changes may be permanent.

To keep your account safe, never paste text here from other sources or send information from this page to others.

You are about to test live API endpoints using your actual account credentials.

Only proceed if you understand the implications of the API calls you're about to make. Review the API documentation carefully before testing.

API calls will be made using your authenticated session

These are real API calls that may affect your account or data

Rate limits and other API restrictions apply

Some operations may modify or delete data

This endpoint has been superseded by these recommended alternative endpoints:

The following scopes are required to call this endpoint. For more
information on generating proper keys, see [Manage API keys]({apiKeyReferenceDocLink}).

For more information on generating keys, see [Manage API keys]({apiKeyReferenceDocLink}).

The following endpoints are available at paths relative to the base URL.

This string is formatted as a [FieldMask](/cloud/reference/types#fieldmask).

A JSON value can be `null`, `boolean`, `string`, `number`, `array`, or `object`.

The following scopes are required for your OAuth 2.0 application to use this endpoint. For more information on how to register an OAuth 2.0 application, see [App registration and review]({oauth2ReferenceDocLink}).

For more information on how to register an OAuth 2.0 application, see [App registration and review]({oauth2ReferenceDocLink}).

The following objects describe payloads that are accepted or returned. See each individual endpoint for more information on when these objects are used.

The following scopes are required to call this endpoint.

Resource Paths

This string is formatted as a [Timestamp](/cloud/reference/types#timestamp).

The following scopes are required for your OAuth 2.0 application to use this endpoint. For more information on how to register an OAuth 2.0 application, see [App Registration and Review]({oauth2ReferenceDocLink}).

Not Recommended

You are viewing the revamped Open Cloud reference.

You've opted out of the new Open Cloud reference.

View your ad campaigns and their performance.

Create, update, and manage your ad campaigns.

This allows viewing information about your assets.

This allows uploading and updating assets to Roblox.

This allows viewing asset permissions for subjects (including groups and experiences) and assets your account has access to.

This allows granting asset permissions to any subjects (including groups and experiences) and assets your account has access to.

This allows you to view the status and results of avatar auto-setup jobs on your behalf.

This allows you to create and manage avatar auto-setup jobs on your behalf.

Grants the ability to update badges owned by the user.

This allows viewing information about your commerce items.

This allows making changes to your synced commerce items.

This allows viewing information about your commerce merchant connections.

This allows editing of your commerce merchant connections.

This allows you to view information about your Creator Store products.

This allows you to modify information about your Creator Store products.

This allows you to view information about your Creator Store saves.

This allows you to modify information about your Creator Store saves.

Grants access to create data stores on your behalf.

Grants access to delete data stores on your behalf.

Grants access to read a list of data stores.

Grants access to take a snapshot of your data stores.

Grants access to create entries in your data stores.

Grants access to mark specified entries for deletion.

Grants access to list your data store's entries.

Grants access to read specified entries in your data stores.

Grants access to update the value, attributes, and users of an entry.

Grants access to delete revisions of your data store's entries.

Grants access to list revisions for your data store's entries.

Grants access to read revisions of your data store's entries.

Grants access to view configuration details for the authorized user's developer products.

Grants access to edit the authorized user's developer products.

This allows viewing information about your universe's environments.

This allows editing of your universe's environments.

Grants access to view configuration details for the authorized user's game passes.

Grants access to edit the authorized user's game passes.

Grants access to view community forums information for your account.

Grants access to manage community forums information for your account.

This allows viewing information about your communities.

This allows you to manage community join requests and role updates of lower-ranked community members for your account.

Allows you to view an instance's property data.

Allows you to modify the property data of instances (currently only supports Scripts).

This allows viewing information about your inventory.

Grants access to manage your badges and spend Robux.

Grants access to update the authorized user's badges.

Grants access to manage your developer products.

Grants access to read information about the experiences you have notifications on for.

Grants access to turn on or off notifications for experiences on your behalf.

Grants access to manage your communities.

Grants permission to read community information.

Grants access to read and write your localization tables

Grants access to manage team collaboration for all experiences you own.

Grants access to manage your experiences and certain information associated with your experiences (e.g. localization information).

Grants access to read your experiences' localization information.

Grants access to modify your experiences' localization preferences.

Grants access to manage your user account.

Grants access to modify user localization preferences.

Allows you to view the status, logs, and results of Luau execution tasks for the associated place.

Allows you to create new Luau execution tasks for the associated place.

Grants access to asynchronously flush all data structures in the universe.

Grants access to discard read items from the front of the queue.

Grants access to read items at the front of the queue.

Grants access to read your memory store items.

Grants access to create, update, and delete map items.

This grants the ability to publish messages on behalf of users.

This allows sending notifications from your experience to users.

(Deprecated) Grants access to read a list of entries in an ordered data store.

(Deprecated) Grants access to create a new entry in an ordered data store.

Grants access to list entries from an ordered data store.

Grants access to create entries in an ordered data store.

This allows listing secrets associated with your experience.

This allows creating and updating secrets associated with your experience.

This permission allows you to submit an evaluation job and view the job result.

Grants access to read about your subscription products.

This allows you to read thumbnail information on your behalf.

Grants the ability to read analytics alerts.

Grants the ability to create or modify analytics alerts.

Grants the ability to read game analytics.

Grants the ability to write resources related to game analytics.

Grants the ability to read place information.

Grants the ability to edit place information.

Grants access to publish new versions of experiences to Roblox.

This allows you to read thumbnails and thumbnail personalization settings for your experiences.

This allows you to upload and delete thumbnails and manage thumbnail personalization settings for your experiences.

Grants the ability to read experience information.

Grants access to edit the authorized user's experiences.

Allows you to view user restrictions in the experience.

Allows you to edit user restrictions in the experience.

This allows viewing notifications sent to your account.

Grants the ability to read the authorized user's premium and verified status.

This allows you to view the authorized user's social accounts.

Grants the ability to read a game's events.

This enables Single Sign-On functionality.

This grants access to read your profile information.

Summary