llLoadURL

function

Function syntax

llLoadURL(

key avatar,// UUID of the avatar in the same region.
string message,// Text message to display in the dialog box.
string url// Web URL to open.

);

Delay: 0.1 s
Energy: 10

Shows dialog to avatar offering to load web page at url with message.

If user clicks yes, launches the page in their web browser, starting the browser if required.

The url is truncated to 255 characters and message is truncated to 254 characters.

The protocol for the url must be specified, currently only “https://” and “http://” are supported.

The URL should be compliant with proper escapes.

llLoadURL(NULL_KEY, "", "");

Caveats

This function should not be called from group deeded objects¹, it will silently fail.
This function silently fails for an avatar that has muted itself.²

Examples

Example 1

12 collapsed lines
default
{
    touch_start(integer num_detected)
    {
        key id = llDetectedKey(0);
        string info = "Visit the Second Life website!";

        // must start with either "http://..." or "https://..."
        string url = "http://www.secondlife.com/";

        integer avatarInSameRegion = (llGetAgentSize(id) != ZERO_VECTOR); // TRUE or FALSE

        if (avatarInSameRegion)
        {
            llLoadURL(id, info, url);
        }
        else
7 collapsed lines
        {
            // if the agent is not in the same region, send a message instead
            // the viewer will turn the URL clickable
            llInstantMessage(id, info + " " + url);
        }
    }
}

Tests

llLoadURL Test

History

Introduced in version 1.6, no support for group deeded objects.
As of version ~1.9, support for group deeded objects was added (possibly by accident).
In the server upgrade released on 2007-03-14, support for group deeded objects was removed.

Original wiki source

Some wiki templates and tables need their original context. View this article on the Second Life Wiki. Technical wording and examples are retained from the source; historical guidance may differ from current behavior.

This was not always the case, see History for details ↩
This can be extremely bewildering to debug because there’s no easy way for a user to self-mute. Apparently it “just happens.” ↩