Jump to content
  • Inventory links

    Jeremy Linden

    Inventory links


    An inventory link points to an original inventory item. If you're familiar with aliases on Mac OS X and symbolic links on Windows and Linux, inventory links behave similarly.

    A link itself is meta, meaning it's entirely referential, dependent on the original, and carries no unique properties that can be modified independently of the original. A link is shown in italics with the word "(link)" beside it:


    Links were introduced to accompany the new outfit system in Viewer 2, which makes it easier to switch between sets of clothes or entire avatar looks.

    In Viewer 1.23 and earlier, making a new outfit would copy all copyable items and move all no-copy items into a single folder, meaning that you could not include no-copy items in multiple outfits.

    Now, making a new outfit creates a link to each item instead. By making multiple outfits, multiple links to a single item can be created, which simplifies keeping track of your original inventory items. Great if you have a pair of shoes you like wearing with several outfits.

    Here's a popular example:

    • You go on a shopping spree and buy several clothing items, each of which comes in its own folder.
    • Some of these items have multiple variations in their own folder which you won't be wearing all at once, like a skirt that comes in several lengths, or hair that comes in several colors.
    • You want to wear these items as a cohesive outfit for quick future retrieval so you won't have to waste time digging around in each folder.
    • But, you don't want to wreck the original folder structure since there may be other items in them like documentation you want to preserve. (Fashion-related goods often include a "read me" notecard, a landmark to the shop, and sometimes a texture with a picture preview.)

    By saving a new outfit, a folder with links to all of the items you're wearing is created. You can easily wear all the items the folder's contents are linked to in a few clicks.

    A link is not the same as a copy

    Warning: Be careful when deleting original items if you've made links to them.

    If you delete an original item, all links to it break since there's nothing to point to. While links may be convenient when you want to refer to the same item in several outfit folders, each link is entirely dependent on an original item.

    Copying an item creates a unique instance of the item that can be copied further, and, dependent on permissions, can be modified or transferred. Keep in mind that links are references without unique properties. For example, you can rename a copied item, but you can't rename a link.

    Finding links in your inventory

    • Search your inventory for "(link)" to see all links.
    • To find the original item that a specific link is connected to, right-click the link and choose Find Original.
    • Inversely, if you click an original item in inventory, you can find all links pointing to it by clicking Icon_Gear_Foreground.png at the bottom and choosing Find All Links.

    Creating new links

    You can't arbitrarily create a link via the usual right-click context menus. To create links, items must be worn on your avatar, and you must create a new outfit, either by clicking the Save Outfit button in the My Appearance sidebar tab, or clicking the Make Outfit button in the Appearance editor.

    However, links can be deleted from your inventory just like any original item:

    1. Click the My Appearance sidebar tab.
    2. Click the My Outfits tab.
    3. Right-click a link and choose Remove Link.
      • If the item is worn, you need to choose Detach From Yourself or Take Off, then right-click again to see Remove Link. This throws the link in your Trash.


    1. Click the Inventory sidebar tab.
    2. Find the link you want to delete. It may be in the My Outfits system folder.
    3. Click the link.
    4. Press the Delete key or right-click the link and choose Delete.
    Note: Links are always dependent on original items, never the other way around. Deleting a link doesn't affect the original in any way. The reverse isn't true: deleting an item breaks all links to it.

    Does wearing a link also wear the original item?

    Not exactly. Remember, the link merely points to the original item. You aren't actually wearing the link per se, the link tells you (1) the name of the original item and that (2) the original is worn.

    Therefore, if you "wear" a link, all instances of the link become bold in your inventory, as does the original item. This doesn't mean you're wearing multiple copies of the same thing, because links are not copies.

    Can an outfit contain a mix of original items and links?

    Yes. This only happens if you manually drag original items into an outfit folder. It doesn't happen if you use Make Outfit as described above, because that always creates links to original items.

    Similarly, an outfit can contain entirely original items with no links, which may be the case if you dragged a pre-Viewer 2.0 "outfit folder" into the current My Outfits system folder.

    We know being able to make an outfit that has copies of the original items is desirable in some cases, like if you're a content creator making color variations of a suit, so we're investigating future possibilities.

    If I copy an original item and modify it, will links created to each copy be independent?

    Yes. Here's why: copying an original item then modifying it results in the the copy being its own unique instance. (You can verify this by right-clicking an item in inventory, choosing Copy Asset UUID, then pasting that. For example, copy a shirt, change the copied shirt's color, then compare UUIDs.)

    Therefore, links to a copy of an item treat this copy as its own "original item". If you copy "item A" so that the copy is "item B" and link to "item B", deleting "item A" doesn't break the links.

    Updating existing links with a new object

    You can change which object a link points to, allowing you to simultaneously update many outfits with an updated item.

    To update a link with a new object:

    1. Open your inventory by clicking the Inventory button.
    2. Find the original object you used in your outfits (the one all your links point to).
    3. Right-click the object in your inventory and choose Replace Links to open the Replace Inventory Links window.  The window also shows how many links have been made to this original object.
    4. In your Inventory, find the new object you wish to replace your old object with.
    5. Drag the new object onto the New field in the Replace Inventory Links window.
    6. Click Start to update all links with the new object.

    Do links cause inventory bloat?

    If you're specifically referring to the total time it shows "Fetching X items..." after you've cleared cache, links count the same as other inventory items. For example, if you were to create 100 outfits and each contains 10 links, that has the same net effect as loading 1,000 original items. You might think of this like a giant spreadsheet, where each original item and each link has a row. Keep in mind that this is a simplified example; other factors like server lag may also affect loading time.

    However, there are a couple advantages to using links:

    1. From your perspective, convenience is a big advantage of links. While it still takes time to load your inventory, particularly if you have 10,000s of items, it can take you less time to switch between outfits instead of micromanaging nested folders as was commonly the case before Viewer 2.0.
    2. From Linden Lab's technical perspective, by reducing the need for redundant copies of the same items worn in multiple outfits, asset space is saved. An inventory link counts as an "entry" in our database, but doesn't have a corresponding unique asset, so the original item that's referred to by a link doesn't take up twice (or more) of the space that making a copy of it would.

    Linden Lab strongly recommends you keep your inventory item count relatively low, just like you wouldn't want a real backpack full of clutter. Periodically archiving or trashing items you never use goes a long way towards saving you future time.


    Some of these limitations may be changed in the future. They include common confusions Linden Lab has been asked about frequently. As of Viewer 2.0.1, it's important to know:

    • Links can't be copied-and-pasted freely.
    • Any changes to an original item affects all links. In other words, no matter how many links point to an original item, there's only one original item. For example, say you have a no-copy pink hat that you've linked to from two outfit folders. You want the hat to remain pink in one outfit folder, but be green in the other outfit folder because that suits the rest of your outfit better. This doesn't work, since the link merely points to the original, and doesn't circumvent the permissions system by creating new copies.
      • Along the same lines, renaming an original item also renames links to it. All of a link's properties are dependent on the original item.
    • Links incorrectly show as broken in some circumstances. For example, if the target inventory item hasn't been fetched (loaded) yet. Wait and see if it resolves. If that doesn't work, try right-clicking a link and choosing Find Original to confirm.
    • Rezzing a no-copy object that a link points to breaks the link. This is because a link depends on an object's unique key, its UUID, to refer to. By removing a no-copy item from your inventory, the link has nothing to point to. Taking the item back into your inventory doesn't restore the link. If you want to edit no-copy attachments, the workaround is to edit it while attached, rather than dropping it on the ground. You will get a warning before dropping an attachment, but it won't tell you that doing so breaks the link.
    • Finding originals that are linked to only works in the My Inventory tab, not the My Outfits tab. My Outfits is a subset view of My Inventory that only shows original items and links that are within the My Outfits system folder, with each outfit in its own folder with this icon: InvIcon_LookFolderClosed.png

    Edited by Jeremy Linden

    User Feedback

    There are no comments to display.

  • Create New...