Plugin Field Options

Use this page to configure JSON options for a custom Plugin field on the template __Standard Values item.

Mode Parameter

The mode parameter determines the selector behavior and sets the Bynder Universal Compact View to allow multiple or single asset selection:

Examples:

{"mode":"SingleSelectFile"}

{"mode":"SingleSelect"}

{"mode":"MultiSelect"}

Asset Types Parameter

The optional assetTypes parameter restricts which asset types are shown in the Bynder Universal Compact View. Accepts any combination of:

• "image" - show images
• "video" - show videos
• "document" - show documents
• "audio" - show audio files

If omitted, all four types are shown.

Example:

{"mode":"SingleSelect","assetTypes":["image","video"]}

Default Search Term Parameter

The optional defaultSearchTerm parameter pre-fills the search box in the Bynder Universal Compact View when it opens.

Example:

{"mode":"SingleSelect","defaultSearchTerm":"Sitecore"}

This parameter can be combined with other parameters and additional options as they are introduced.

Hide Limited Usage Parameter

The optional hideLimitedUse parameter controls whether assets marked as limited usage are hidden in the Bynder Universal Compact View. If set to true, limited usage assets are hidden for all users.

• true - hide limited usage assets
• false - show all assets (default)

Example:

{"mode":"SingleSelect","hideLimitedUse":true}

This parameter can be combined with other parameters and additional options as they are introduced.

Store Meta Properties Parameter

The optional storeMetaProperties parameter controls whether selected asset metadata is persisted with the field value.

• true - persist metadata with the selected assets
• false - persist selected assets without additional metadata (default)

Example:

{"mode":"SingleSelect","storeMetaProperties":true}

This parameter can be combined with other parameters and additional options as they are introduced.

Combined Configuration Examples

Enter valid JSON in the Plugin field's __Standard Values value. The examples below focus on combined options.

Single Selection with Image/Video Filter and Default Search Term

{"mode":"SingleSelect","assetTypes":["image","video"],"defaultSearchTerm":"Sitecore"}

Single File with Specific Types

{"mode":"SingleSelectFile","assetTypes":["image","video"]}

{"mode":"SingleSelectFile","assetTypes":["image"]}

Single Selection with Image Only

{"mode":"SingleSelect","assetTypes":["image"]}

Single Selection with Video Only

{"mode":"SingleSelect","assetTypes":["video"]}

Multi Selection with Images and Videos

{"mode":"MultiSelect","assetTypes":["image","video"]}

Multi Selection with Document Only

{"mode":"MultiSelect","assetTypes":["document"]}

Multi Selection with All Types Except Audio

{"mode":"MultiSelect","assetTypes":["image","video","document"]}

Single Selection with a Default Search Term

{"mode":"SingleSelect","defaultSearchTerm":"Sitecore"}

Multi Selection with Video Filter and Default Search Term

{"mode":"MultiSelect","assetTypes":["video"],"defaultSearchTerm":"Sitecore campaign"}

Single Selection with Explicit Metadata Storage Enabled

{"mode":"SingleSelect","storeMetaProperties":true}

Important Notes

• Valid JSON required - Invalid JSON falls back to SingleSelectFile with all asset types and no defaultSearchTerm
• Metadata persistence default - storeMetaProperties defaults to false when omitted or when JSON is invalid
• Plain JSON only - Do not wrap JSON manually in XML tags
• Legacy format support - For legacy XP/XM XML values (<asset><![CDATA[{"type":"Assets",...}]]></asset>), the connector infers mode automatically based on type and selected asset count
• DAT support - SingleSelectFile mode supports creating Dynamic Asset Transformations (DAT) on the fly