Field Types

42 supported field types with full inline editing in the bulk editor.

Coverage Overview

Metaobjects in Shopify can store data in many different field types, from simple text and numbers to complex structured data like rich text, references, and measurements. Structa supports editing all of the most commonly used field types directly in the bulk edit table, with full validation and inline editing.

The app currently supports 42 out of 52 Shopify field types (81% coverage):

Category	Supported	Total	Coverage
Standard types (text, number, date, etc.)	18	18	100%
Reference types (product, collection, etc.)	9	11	82%
List types (multi-value variants)	15	23	65%

Text Fields

Text fields store text content of varying lengths and formats.

Single Line Text

Stores a single line of plain text. Ideal for names, titles, SKUs, or short descriptions.

Click the cell to type or edit text directly in the table. The field validates against any character limits set in the metaobject definition.

Multi-Line Text

Stores multiple lines of plain text without formatting. Perfect for longer descriptions, notes, or comments.

Click the cell to expand a text area where you can type or paste multi-line content. Press Enter to create new lines.

Rich Text

Stores formatted text with bold, italic, links, and other formatting options. The bulk editor displays a formatted preview of the text.

Click the cell to open a rich text editor in a popover. Use the toolbar to format your content, then click Save. The preview shows up to 100 characters of plain text extracted from your formatted content.

Number Fields

Number fields store numeric values. Shopify supports both integers and decimals.

Integer

Stores whole numbers with no decimal places. Use for quantities, counts, or ratings that must be whole numbers.

Click the cell to type a whole number. The field prevents decimal input.

Decimal

Stores numbers with up to many decimal places. Use for prices, measurements, or values that need precision.

Click the cell to type a decimal number. Use a period (.) as the decimal separator.

Date & Time Fields

Date

Stores a date without time information (YYYY-MM-DD format). Appears as a human-readable date in the table.

Click the cell to open a date picker calendar in a popover. Select your date and click Save. The table displays the date in a short format like "Jan 15, 2024".

Date and Time

Stores a complete date and time with timezone support. Appears as a formatted timestamp in the table.

Click the cell to open a date and time picker in a popover. Select both the date and time, then click Save.

Special Fields

Boolean (True/False)

Stores a simple true or false value. Displays as a toggle switch in the table.

Click the switch to toggle between true and false. When a value hasn't been set, the field shows "Not set" and the switch is unchecked.

Color

Stores a color as a hex code (e.g., #FF5733). Click the cell to open a color picker where you can select a color visually or enter a hex code directly.

The color picker shows both a color selection interface and an input field for precise hex values. You can also type hex codes directly.

Rating

Stores a numeric rating value within a defined scale (typically 1-5 stars). The bulk editor shows the current rating as "3.5 out of 5", for example.

Click the cell to open a rating editor. Click stars to set the rating, or use the number input for precise values. The scale (min/max) is determined by the field definition.

Money

Stores an amount with currency. The currency is always locked to your store's base currency and cannot be changed per-field.

Click the cell to enter a numeric amount. The field shows your store's currency symbol (like $ or €) and only accepts numbers and decimal points. The editor automatically formats to 2 decimal places.

Link

Stores both a link URL and display text. This is a compound field that holds two pieces of information.

Click the cell to open the link editor popover. Enter both the link text (what shoppers see) and the URL. If the field has domain restrictions, they're displayed as a reminder.

URL

Stores a URL string (e.g., https://example.com). Useful for storing single URLs without associated text.

Click the cell to type or paste a URL directly in the table. The field accepts any valid URL format.

ID

Stores a unique identifier string for the entry. ID fields are validated for uniqueness across all entries in the same definition — if two entries share the same ID value, both will show a duplicate error.

Click the cell to type or edit the ID value directly.

JSON

Stores arbitrary JSON data. Useful for storing structured data that doesn't fit standard field types.

Click the cell to open a JSON editor popover with a text area. Paste or write valid JSON, and the editor validates your syntax. Invalid JSON shows an error message and prevents saving.

Reference Fields

Reference fields link to other Shopify resources or metaobjects. They store the unique identifier (GID) of the referenced item.

Product Reference

Links to a specific Shopify product. Displays the product thumbnail, title, and a link to view it in Shopify admin.

Click the cell to open the product picker. Browse and search your products, then select one. The field shows the product's image, title, and a link icon to open it in the admin.

Product Variant Reference

Links to a specific product variant. Works similarly to product reference but at the variant level.

Click the cell to open the variant picker. Search for and select a specific variant from your store's products.

Collection Reference

Links to a Shopify collection. Display shows the collection's name.

Click the cell to open the collection browser. Search and select a collection to link to.

Customer Reference

Links to a specific customer in your store. Displays the customer's ID or name if available.

Click the cell to open the customer picker and select a customer from your store.

Page Reference

Links to a Shopify store page. Displays the page identifier or name.

Click the cell to browse and select from your store's pages.

File Reference

Links to a file stored in your store's file system. Displays a thumbnail (for images) or file icon, along with the filename.

Click the cell to open the file picker. Select from your store's files, or upload a new file. The editor shows a preview when available.

Metaobject Reference

Links to another metaobject, allowing you to create relationships between different metaobject types. The field displays the referenced metaobject's ID or name.

Click the cell to open a dropdown showing available metaobjects of the correct type. Select one to create the reference.

Mixed Reference

A special reference type that can link to multiple different resource types. A two-step picker first asks you to choose the resource type, then lets you select the specific item.

Click the cell to open the resource type selector. Choose the type (product, customer, etc.), then select the specific item.

Product Taxonomy Value

Links to a value in Shopify's product taxonomy system (used for standardizing product attributes like color, size, material). Displays the taxonomy value name.

Click the cell to open the taxonomy picker. The editor shows available taxonomy values for the attribute and a search function to find specific values.

Choice Fields

Choice List (Dropdown)

Stores a single selected value from a predefined list of choices. The choices are defined in the metaobject definition.

Click the cell to see a dropdown menu of available choices. Select one option. The field displays the selected choice.

Choice List (Multi-Select)

Stores multiple selected values from a predefined list. You can select as many options as needed.

Click the cell to open a popover with checkboxes for each choice. Check multiple options to select them. A tag shows "3 selected" if you've chosen multiple values.

Measurement Fields

Measurement fields store a numeric value paired with a unit of measurement. The bulk editor provides both a number input and a unit dropdown.

Weight

Stores a weight value with unit (kg, g, lb, oz, etc.). Click the cell to enter a weight number and select the unit from a dropdown.

Volume

Stores a volume measurement with unit (liters, gallons, milliliters, etc.). Click the cell to open the volume editor and enter both a numeric value and select a unit.

Dimension

Stores dimensions (length, width, height) with a unit. Useful for physical product specifications.

Click the cell to enter dimension values and select the measurement unit (inches, centimeters, etc.).

List Fields

Most field types have a "list" variant that allows storing multiple values instead of just one. For example:

• Single Line Text List — stores multiple text values (like tags or keywords)
• Product Reference List — stores multiple product references
• Date List — stores multiple dates
• Color List — stores multiple colors
• URL List — stores multiple URLs

How list fields work in the bulk editor

Click the cell to open a popover showing all currently stored values as a list. You can:

• Add new values using the "Add" button or input at the bottom of the list
• Remove values by clicking the delete icon on any item
• Edit existing values by clicking on them
• Drag to reorder items by grabbing the drag handle on the left side of each item and moving it up or down

The drag-to-reorder feature works with mouse and keyboard. Items show a grab cursor on the handle, and you get visual feedback (rotation and opacity changes) while dragging. Reordering is restricted to vertical movement only.

List fields make it easy to store related data without creating separate metaobjects. For example, a "Related Products" field is a Product Reference List that stores links to multiple products.

Not Yet Supported

The following field types are not yet supported in the bulk editor (10 out of 52 total — 81% coverage):

Reference types

• Article reference
• Company reference

List types

• Article reference list
• Dimension list
• ID list
• Mixed reference list
• Page reference list
• Rating list
• Volume list
• Weight list

Tips for Efficient Editing

• Keyboard navigation — Use Tab / Shift+Tab to move between cells, Cmd/Ctrl+Arrow keys to jump rows/columns, and Enter to save field editors.
• Assign to all — Use the cell action menu to copy a single cell's value to the same field across all rows.
• Search and filter — Use the table's search and filter features to focus on specific entries before bulk editing.
• Discard to revert — Click Discard before saving to throw away all unsaved changes for this session.
• Smart revert — If you change a value back to its original, the app automatically removes it from the unsaved changes list.

Validation Errors

If you see a validation error when saving:

1. Check that required fields are filled
2. Ensure text doesn't exceed character limits
3. Verify numbers are within allowed ranges
4. Confirm that restricted choices are from the allowed list
5. For references, make sure the referenced item still exists in your store