Bulk Editor
Edit all your metaobject entries in a spreadsheet-style table with inline editing.
Opening the Bulk Editor
- From the app homepage, select a metaobject definition from the Definitions list.
- Click Bulk Edit to open the table view.
- The editor loads all entries for that definition into a single scrollable table.
To switch to a different definition, use the type selector at the top of the page. The table updates immediately.
The bulk editor supports up to 5,000 entries per definition. Use search, filters, and saved views to navigate large datasets. Free-plan stores may see fewer entries depending on plan limits — see Plans & Billing for details.
Understanding the Table
The table displays your metaobject entries as rows and your fields as columns:
- Rows — Individual entries (e.g., "Red Color", "Blue Color")
- Columns — Fields defined in your metaobject type (e.g., "Name", "Hex Code", "Description")
The first column shows the entry's display name, followed by status and template columns (if the definition supports them), then all your custom fields.
Editing Entries
- Click on any cell in the table.
- An editor appears for that field type (text input, dropdown, date picker, etc.).
- Make your change — the row highlights to show it has unsaved edits.
- Nothing is written to Shopify until you save.
Field Types and Editors
Different field types have different inline editors:
- Text fields — Type directly in the input
- Number fields — Enter numerical values
- Date / DateTime fields — Use a date picker
- Boolean fields — Toggle yes/no
- Dropdown fields — Select from predefined options
- Reference fields — Search and select related items (products, collections, files, etc.)
- Rich text — Multi-line editor with formatting
- List fields — Add multiple values in a list editor
Some field types have limited editing in bulk mode. For complex edits, use the row menu's "Edit in Shopify admin" option. See the Field Types guide for details on each type.
Saving Your Changes
The Save Bar
When you have unsaved changes, a save bar appears at the bottom of the screen:
- Save — Sends all your changes to Shopify
- Discard — Throws away all unsaved changes
- Cmd/Ctrl+S — Keyboard shortcut to save
Validation
Before saving, Structa checks all edited fields for errors:
- Required fields must have values
- Text fields must meet length requirements
- Numbers must be in valid ranges
- Email and URL fields must be properly formatted
- ID fields are checked for uniqueness — duplicates block saving
If any field has an error, the error message appears below the field and the save is blocked. Fix the errors and try again.
Partial Saves
If some rows fail (e.g., due to a server error), the successfully saved rows are committed and the failed ones remain in the editor so you can fix and retry them.
Discard only clears unsaved work. It does not revert anything already saved to Shopify.
Searching and Filtering
Search
Use the search box (or Cmd/Ctrl+F) to filter entries. Search matches across display name, handle, and field values.
Column Filters
For fields with a manageable number of unique values, filter dropdowns appear in the toolbar. You can combine multiple filters at once.
Sorting
Sort entries by display name, handle, or last updated date.
Saved Views
Save your favorite search and filter combinations as views:
- Set up your search and filters.
- Click Save as from the "All" tab dropdown.
- Give it a name (e.g., "Active Red Products").
- The view appears as a tab above the table — click it to reapply those filters.
You can rename, duplicate, update, or delete saved views. The "All" tab cannot be deleted. Views are saved per definition in your browser.
Column Controls
Show, hide, and reorder columns to focus on the fields you care about. Column preferences are saved per definition in your browser.
Hidden columns do not affect CSV export — export always includes all fields in the definition.
Adding New Entries
- Click Add entry at the top of the page.
- Shopify's native metaobject editor opens.
- After you save there, the bulk editor refreshes to include your new entry.
If your plan's entry limit has been reached, the add button is disabled until you upgrade or free up space.
Row Actions
Each row has a three-dot menu with these actions:
| Action | Description |
|---|---|
| Edit in Shopify admin | Opens the entry in Shopify's native editor. When you return, the row refreshes automatically. |
| Duplicate entry | Creates a copy of the entry with all field values. Requires a paid plan. |
| Set all to Active / Draft | Changes the status of all entries at once. Only shown for publishable definitions. |
| Reset all templates to default | Clears template suffixes on all entries. Only shown when online store templates are enabled. |
| Delete entry | Permanently deletes the entry from Shopify. A confirmation dialog appears first — this cannot be undone. |
Cell Actions
Right-click or use the action button on any cell for these options:
| Action | Description |
|---|---|
| Assign to all | Copies this cell's value to the same field across all visible rows. Useful for bulk-setting a field to the same value. |
| Clear | Removes the value from this cell. |
These actions also work on Status and Template columns.
Publishable Status and Templates
Some metaobject definitions support publishing and online store templates. When enabled, extra columns appear in the table:
- Status — Set entries to Active (published) or Draft (hidden)
- Template — Choose which template variant to use for each entry on your storefront
Edit these just like any other column — changes are included when you save.
CSV Export
Click Export CSV in the toolbar to download your entries as a spreadsheet file:
- Exports the rows you currently see (respects search, filters, and sorting)
- Includes all fields in the definition, even if some columns are hidden
- Adds Display Name, Handle, and Status columns automatically
- Opens correctly in Excel and Google Sheets
See Export & Import for details on how different field types are formatted, CSV import, and definition transfer.
Keyboard Shortcuts
The bulk editor supports keyboard shortcuts for saving, searching, and navigating cells. See Keyboard Shortcuts for the full list.
If the bulk editor is saving you time, a quick review on the Shopify App Store helps other merchants find us. It only takes a minute.