Overview

The media collection provides access to images and videos uploaded via the MX8 Labs dashboard. These media items can be used in questions, filtered dynamically, and reported on using their associated metadata.

The media system is designed for:

• Ad or concept testing
• Filtering or tagging by metadata
• Dynamically pulling content into questions

If no media has been uploaded, a dummy set is used with the default columns:

• name, description, product, brand, campaign, agency, id

You can create and upload your own metadata columns via the MX8 Labs dashboard.

@property media

Accesses the full media collection. Returns a MediaCollection object which can be iterated and queried.

for media in s.media: s.select_question("What do you think of this image?", options=["Like", "Dislike"], image=media)

get_media_values(column: str)

Returns all values from a specific metadata column in the media collection.

Parameter	Type	Required	Description
column	str	yes	The column name to extract unique values from

car_brands = s.get_media_values("brand")

get_image(**filters)

Returns a single image matching the provided metadata filters.

ford_image = s.get_image(brand="Ford") s.image_question("What do you think of this Ford car?", image=ford_image)

get_video(**filters)

Returns a single video matching the provided metadata filters.

ford_video = s.get_video(brand="Ford") s.play_video(video=ford_video)

get_images(**filters)

Returns a list of images that match the provided metadata filters.

for image in s.get_images(brand="Ford"): s.image_question("What do you think of this Ford car?", image=image)

get_videos(**filters)

Returns a list of videos that match the provided metadata filters.

for video in s.get_videos(brand="Ford"): s.play_video(video=video)

Notes

• You can chain filters using multiple keyword arguments (e.g. brand="Ford", campaign="Summer")
• These tools allow dynamic, personalized question flows based on metadata
• Media metadata is automatically included in reporting for grouped analysis
• All media must be uploaded via the MX8 Labs dashboard and tied to the current survey project