# llSetObjectDesc

*LSL function*

```lsl
void llSetObjectDesc(string description);
```

- `string description`: New description string (up to 127 characters).

- Energy: 10

Sets the description of the prim containing the script to description (limited to 127 characters).

Sets the prims description

```lsl title="How to use" frame="terminal"
llSetObjectDesc("");
```

## Caveats

- Changing the object description does not trigger a [changed](/events/changed/) event.

## Examples

<table>
	<tr>
		<th>**Set this prim's description**</th>
		<th>**Set the root prim's description**</th>
	</tr>
	<tr>
		<td>

			```lsl
			default
			{
			    state_entry()
			    {
			        llSetObjectDesc("NEW PRIM DESCRIPTION");
			    }
			}
			```

		</td>
		<td>

			```lsl
			default
			{
			    state_entry()
			    {
			        llSetLinkPrimitiveParamsFast(LINK_ROOT,
			            [PRIM_DESC, "NEW ROOT PRIM DESCRIPTION"]);
			    }
			}
			```

		</td>
	</tr>
</table>

## Notes

- Object descriptions are often used to store data that needs to be protected from script resets (see, for example, [Prim Attribute Overloading](https://wiki.secondlife.com/wiki/Prim_Attribute_Overloading)). However, descriptions are not immutable and can be tampered with by users or other scripts, either intentionally or accidentally, so this method should only be considered a last resort for data storage.
- [llLinksetDataWrite](/functions/llLinksetDataWrite/) and associated functions are generally better suited for this purpose, because they allow for significantly more data storage and are much more secure against tampering.

## Known issues

From the issue templates included by the wiki article:

- VWR-437 (bug): llSetObjectDesc and editor panel have different description string length limits
- SVC-3429 (bug): Name or description change, of an attached object, is rolled back when object is detached
- VWR-8761 (bug): Cannot delete object description.

## See also

### Functions

- [llGetObjectDesc](/functions/llGetObjectDesc/) — Gets the prim description.
- [llGetObjectName](/functions/llGetObjectName/) — Gets the prim name.
- [llSetObjectName](/functions/llSetObjectName/) — Sets the prim name.

---

*Source: [LlSetObjectDesc](https://wiki.secondlife.com/wiki/LlSetObjectDesc) on the Second Life Wiki. Content from the Second Life Wiki articles LlSetObjectDesc (revision 1218380, 2025-07-28), Template:Issues/VWR-437 (revision 298362, 2009-03-31), Template:Issues/SVC-3429 (revision 701123, 2010-01-11), Template:Issues/VWR-8761 (revision 1164250, 2012-03-19) and Template:LSL Function/prim-desc (revision 1218641, 2026-02-23), CC BY-SA 3.0.*

---

From lsl.dev: https://lsl.dev/functions/llSetObjectDesc/