Table of Contents

SiteVisibility

The SiteVisibility property set controls whether a product item (pre-built composition, part, or material) appears in the planner library for a given site. It works together with the library tag catalog and the site-level tag enable/disable model already used by SalesCodeMapping.

Property Name Type Localized Description
Tags Tag List N One or more library tags that determine on which sites this item is visible.

Supported item types

SiteVisibility can be added to:

  • Pre-built compositions — controls which pre-configured starting states are offered to the end user.
  • Parts — controls which parts appear in the planner library option list.
  • Materials — controls which materials appear in the planner library option list.

Behavior

SiteVisibility state Result
Property set not added Item is visible on all sites (unrestricted).
Property set added, one or more tags selected Item is visible only on sites where at least one of the selected tags is enabled.
Property set added, no tags selected Item is hidden on every site. Runtime regeneration emits warning W0025 to flag the likely configuration error.

Tag catalog

Tags are defined per library in Product Libraries > Tags. The built-in Common tag (Guid.Empty) is always present and cannot be deleted. It is enabled by default for all sites.

To make an item visible on all sites that have any active tag configuration, add the Common tag to its SiteVisibility property set.

Note

Tags are shared between SiteVisibility and SalesCodeMapping. Enabling or disabling a tag in Site Configuration > Product Catalog > Tags affects both option visibility and SKU mapping filtering.

Setup

  1. Select the pre-built composition, part, or material in the Product Tree.
  2. In the Item property view panel, add the SiteVisibility property set.
  3. In the Tags field, pick one or more tags from the library tag catalog.
  4. On the target site, navigate to Site Configuration > Product Catalog > Tags and enable the matching tags.
  5. Publish the product. The updated visibility takes effect immediately for sessions started after the publish.

Warnings

Code Message Cause
W0025 SiteVisibility property set is present but has no tags selected. The item will be hidden on all sites. A SiteVisibility property set exists on the item but its tag list is empty. Either select at least one tag or remove the property set to make the item unrestricted.