Quick Search: Related Post Thumbnail

Voxel's Quick Search shows each result with a thumbnail pulled from one of the post's own image fields. But sometimes the best thumbnail lives on a related post — an event should show its venue's logo, a collection should show its featured place. This function makes that possible.

Overview

Enabling this function adds a Related post (VT) option to the Search result thumbnail displays setting in Voxel's post type editor (under Quick search). Selecting it reveals two sub-options:

• Relation field — which post relation field to follow
• Image field on related post — which image field of the related post to use

At search time, the thumbnail resolves through the relation: the first related post with an available image wins.

Key Features

• Pull Quick Search thumbnails from any related post's image field
• Works with any relation type and any image field (including profile avatars)
• Falls back through multiple related posts until an image is found
• A related post's "Default image" setting counts as a fallback
• Stored in Voxel's own post type settings — exports and imports with your configuration

Setup Instructions

1. Navigate to Voxel Toolkit → Functions and enable Quick Search: Related Post Thumbnail
2. Go to Voxel → Post Types and open the post type
3. Navigate to General → Quick search
4. Set Search result thumbnail displays to Related post (VT)
5. Choose the Relation field and the Image field on related post
6. Save changes

How Resolution Works

1. The search result's post is checked for the chosen relation field
2. Its related posts are checked in order for the chosen image field
3. The first available image is used as the thumbnail
4. If a related post has no image but its field has a Default image, that counts
5. If nothing resolves, Voxel's default thumbnail icon shows as usual

Use Cases

Events Showing Venue Logos

Events related to a Place show the place's logo in search results — instantly recognizable.

Collections Showing Member Images

A collection result displays the image of its first item.

Listings Showing Owner Avatars

Relate listings to profiles and show the owner's avatar on results.

Troubleshooting

The option doesn't appear in the dropdown

• Verify the function is enabled and the post type has at least one post relation field
• Hard-refresh the post type editor

Results show the default icon instead of the related image

• Confirm the post actually has a related post selected in that relation field
• Confirm the related post has an image in the chosen field (or a Default image on it)

The wrong image shows

• With multiple related posts, the first one with an available image wins — check the relation's order