Files and metaobjects
Use images and Shopify metaobject entries in custom navigation.
File fields
Create a File field, select a menu item and upload an image. Custom-field image uploads accept PNG, JPEG or WebP up to 5 MB. Appearance icons have a separate 512 KB limit.
The published File value contains the file’s Shopify CDN URL. It does not include image dimensions or alternative text. Your theme developer should provide appropriate alternative text and layout dimensions when rendering it.
Successfully uploaded files belong to the store’s Shopify Files library. Clearing a field, replacing an image or uninstalling MenuFields does not automatically delete these files because they may be used elsewhere.
Metaobject references
Create the metaobject definition and entries in Shopify, then create a MenuFields Metaobject reference field using the intended type. Select a menu item, search the available entries and choose one. Use Load more when additional results are available.
MenuFields validates that the selected entry belongs to the configured type. It publishes reference details such as the entry’s type, handle and display name; it does not copy all of the metaobject’s fields.
A theme developer resolves the selected entry through Shopify’s metaobjects object and reads its own field keys. The entry and definition must be available to the storefront for Liquid to render their content.
If a reference is missing
Check that the file or metaobject still exists, that the chosen metaobject has the correct type and that storefront access is enabled where required. Reselect the entry, save and republish if the source changed.
Changing the definition’s metaobject type clears saved selections after confirmation. Review all affected menu links before publishing again.
Continue with Liquid integration.