Udo Support

Select Item lets a visitor choose an item from a list. Select Item View shows
content for the item they chose.

For example, you could let a visitor choose:

• a product from a product group, with specific price and add to cart buttons

• a clothing size, with add to cart button

• a location and then show information about that location.

• an art print size, showing dimensions, finishing, pricing and add to cart

How the two blocks work together

1. Add a Select Item block.

2. Choose which items should appear by setting its filter. (e.g. child product simple, or unrelated Art Print Price

3. (optional) Give it a short Variable Name, such as prod or size.

4. Add a Select Item View block to the same page or layout.

5. Give the view the same Variable Name.

6. Add the content you want to show inside the view, this will display the fields from the item selected by the filter.

The Variable Name connects the two blocks. It must match exactly in both
places. Use a simple lowercase name without spaces or punctuation.

Select Item

The Select Item block controls what visitors can choose.

Filter

The filter decides which items are available. Use it in the same way as other
filtered lists in the builder: choose the item type, tags, relationship and
maximum number of results you need.

Each choice currently displays the item's title and uses its ID as the saved
selection.

Display mode

You can present the choices in either of these ways:

• Drop-down list — useful for longer lists or when space is limited.

• Buttons — useful for a small number of important choices.

The active button is highlighted. In drop-down mode, the first option uses the
configured field label, such as “Select an artist…”. Choosing that first option
clears the selection. Button style can by customised by CSS style editor.

When no choices are available

Content placed inside the Select Item block is shown only when its filter finds
no choices. This is a good place for a short message such as “No options are
currently available.” or "All options are sold out"

Select Item View

The Select Item View displays content for the chosen item.

It has two content areas:

1. Selected item content — shown when the visitor has made a valid choice.
   Blocks placed here use the chosen item, so fields, images and other content
   can display that item's information.

2. No selection content — shown before a choice is made, or after the
   selection is cleared. This can contain instructions such as “Choose an
   artist to view their work., or show a price range, or other placeholder content.

You can add more than one Select Item View with the same Variable Name. They
will all respond to the same selection. This could be used to updaste information in mulitple places (eg, replace feature image, or specification table, etc).

What visitors experience

When a visitor makes a choice:

• the matching content updates without reloading the whole page;

• the selection is added to the page address;

• browser Back and Forward navigation continues to work;

• a copied page address can retain the selection.

Troubleshooting

The view says it cannot find a matching Select Item

Check that both blocks are in the same page or layout and that their Variable
Names match exactly.

The list is empty

Check the Select Item filter. Confirm that matching items exist and are
available on the website.

The wrong blocks respond to a selection

Give each independent selector a unique Variable Name. Only views intended to
share a selection should use the same name.

The selected content is blank

Confirm that blocks have been added to the selected-item area of Select Item
View and that the chosen item contains the fields or images those blocks use.