Bulk Editor

Edit all your metaobject entries in a spreadsheet-style table with inline editing.

Accessing the Bulk Editor

1. From the app homepage, select a metaobject type from the Definitions list.
2. Click the Bulk Edit button to open the table view.
3. The Bulk Editor loads with all entries for that type displayed in a table.

To switch to a different metaobject type, use the type selector at the top of the page and choose a different type from the dropdown. The table updates immediately.

Understanding the Table Layout

The Bulk Editor displays your metaobject entries as a table:

• Rows = Individual metaobject entries (e.g., "Red Color", "Blue Color")
• Columns = Fields defined in your metaobject type (e.g., "Name", "Hex Code", "Description")

Each cell shows the current value for that entry's field. The first column always shows the entry name, followed by any publishable status or template options (if enabled), then all the custom fields.

Editing Entries Inline

Making Changes

1. Click on any cell in the table.
2. An editor appears for that specific field (text input, dropdown, date picker, etc.).
3. Make your change.
4. The change is saved to your editing session (not to Shopify yet).

When you edit a cell, the entire row becomes highlighted to indicate unsaved changes. Field errors (like invalid email format) display below the field with a red background.

Field Types and Editing

Different field types have different editors:

• Text fields — Type directly into the input
• Number fields — Enter numerical values only
• Date/DateTime fields — Use a date picker
• Boolean fields — Toggle yes/no or true/false
• Dropdown fields — Select from predefined options
• Reference fields — Search and select related items (products, collections, etc.)
• Rich text — Multi-line text editor with formatting
• List fields — Add multiple values in a list editor

Saving Your Changes

The Save Bar

When you make changes to any entries, a save bar appears at the bottom of your screen with two actions:

• Save — Applies all your changes to Shopify
• Discard — Throws away all changes in the current session

The save bar only appears when you have unsaved changes.

How to Save

1. Click the Save button in the save bar, or press Cmd+S (Mac) / Ctrl+S (Windows/Linux).
2. All edited rows are submitted together. Each row shows a loading spinner while saving.
3. Once complete, the save bar disappears.

There is no limit on how many entries you can save at once. If some entries fail (e.g., due to a server error), the successfully saved entries are committed and the failed ones remain in the editor so you can retry.

Validation Before Saving

Before you save, the app 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 — duplicate IDs block saving

If any field has an error, the app displays the error message in red below that field and prevents saving. The entire row is highlighted in a critical tone. Fix the errors and try again.

Discarding Changes

1. Click the Discard button in the save bar.
2. Confirm the action in the prompt that appears.
3. All changes for this session are reverted and the save bar hides.

Searching and Filtering

Search by Name

1. Click the search box near the top of the table (or press Cmd/Ctrl+F).
2. Type the entry name you are looking for.
3. The table updates to show only matching entries.

The search looks for your text across the entry name, display field, and all field values.

Filter by Field Values

For fields with a reasonable number of unique values (1–50), filter dropdowns are available in the toolbar:

1. Open the filter panel from the search/filter bar.
2. Select a field and choose the value(s) you want to see.
3. The table updates to show only matching entries.

You can have multiple filters active at once. For example, filter to show only "Active" entries with a specific color. Filters are not available for complex field types like JSON, rich text, or file references.

Saved Views

Save your favorite filter combinations to return to them later:

1. Set up your search and filters the way you want.
2. Click Save as from the "All" tab dropdown to create a new view.
3. Give it a name (e.g., "Red Products Only").
4. The view appears as a new tab above the table.
5. Click any view tab to instantly apply its saved filters and search.

Managing Views

• Rename — Change a view's name from its dropdown menu
• Duplicate — Create a copy of a view
• Save — Update an existing view with your current filters
• Delete — Remove a view you no longer need (the "All" tab cannot be deleted)

Adding New Entries

1. Click the Add entry button at the top of the page.
2. Shopify's native metaobject editor opens where you can fill in all field values.
3. After saving in the Shopify editor, the bulk editor table automatically refreshes to include your new entry.

Row Actions

Each row in the table has a three-dot menu button on the right side with these actions:

Action	Description
Edit in Shopify admin	Opens the entry in Shopify's native metaobject editor. When you return, the row refreshes automatically to reflect any changes made.
Duplicate entry	Creates a copy of the entry with all field values. The new entry appears at the bottom of the table. (Premium feature — requires a paid plan.)
Set all to Active	Sets the status of all entries to "Active" (only shown for publishable definitions).
Set all to Draft	Sets the status of all entries to "Draft" (only shown for publishable definitions).
Reset all templates to default	Clears template suffix 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 action cannot be undone.

Cell Actions

Right-click or use the action button on any cell to access these options:

Action	Description
Assign to all	Copies this cell's value to the same field across all rows. Useful for bulk-setting a field to the same value. Rows that already have the value won't be marked as edited.
Clear	Removes the value from this cell.

These cell actions are also available for Status and Template suffix columns.

Working with Large Datasets

The bulk editor loads all entries for a definition at once into a single scrollable table (up to 5,000 entries). There is no client-side pagination — you see everything in one view.

Use search and filters to narrow down what you see. The app fetches data in the background so the table appears quickly even with large datasets.

Publishable Status

Some metaobject types support publishing, which controls whether entries are visible on your storefront:

• Active — The entry is published and visible
• Draft — The entry is not yet published and is hidden

Each entry has a status dropdown in a dedicated column. Change the status and save to update Shopify.

Online Store Templates

Some metaobject types can use custom templates to display differently on your storefront:

• If your theme has template variants, a Template column appears in the table.
• Select which template variant to use for each entry.
• If no templates are available, click Create template to set one up in your theme editor.

Keyboard Shortcuts

The Bulk Editor supports a full set of keyboard shortcuts for navigation, editing, and saving. See Keyboard Shortcuts for the complete reference.

Exporting Data

You can export your entries as CSV and your definitions as JSON directly from the Bulk Editor. See Export & Import for full details on export formats and options.