# Structa

> Shopify app for managing metaobject entries in a spreadsheet-style editor.

Structa is for merchants and store teams who use Shopify metaobjects as structured content. It is centered on one-definition-at-a-time bulk editing, entry import and export, definition transfer between stores, and optional AI-assisted workflows that always require human review before changes reach Shopify.

## Product summary

Structa supports these main workflows:

1. Open a metaobject definition in a spreadsheet-style table.
2. Edit many entries inline and save the changed rows together.
3. Export the current table to CSV.
4. Import entry data from CSV.
5. Export or import definition structure as JSON.
6. Connect AI tools through MCP and approve or reject proposed changes in a review queue.

## Core behavior

### Bulk editor

- Users work with one definition at a time.
- Entries appear as rows and fields appear as columns.
- Cells are edited inline with field-specific editors.
- Edits stay unsaved until the user clicks Save or uses the save shortcut.
- Save can partially succeed; failed rows remain in the editor so the user can retry them.
- Search, filters, sorting, saved views, and column controls help manage large tables.

### Current bulk editor limits

- The bulk editor currently supports up to 5,000 entries per definition.
- Some stores may see fewer rows if their plan limits visible or editable entries.
- Hidden columns do not change what the CSV export includes.

### CSV export

- Export starts from the bulk editor.
- It uses the rows currently displayed after search, filters, and sorting.
- It includes all fields in the definition, not only the currently visible columns.
- It also includes system columns such as Display Name, Handle, and Status when relevant.
- It is formatted to open cleanly in spreadsheet tools such as Excel and Google Sheets.

### CSV import

- CSV import is for entry data, not definition structure.
- Current import limits are 250 rows and 5MB per file.
- If a row has a Handle value, Structa updates that entry or creates it if it does not exist.
- If a row has no Handle, Structa creates a new entry.
- Common spreadsheet values such as booleans, numbers, dates, colors, lists, and many structured values are parsed automatically.
- Some reference types can be matched from names, handles, or filenames, but other reference types work best when the CSV already contains Shopify GIDs.
- Import can partially succeed and report row-level failures.

### Definition export and import

- Definition export downloads the schema for a metaobject definition as JSON.
- Definition import creates a new definition from a JSON file.
- These workflows move structure, validations, and settings.
- They do not move entry data.

### AI / MCP integration

- Structa exposes an MCP server at `https://metaobject-editor.heystructa.com/api/mcp`.
- Users can generate API tokens inside the app.
- Compatible AI tools can connect and propose create, update, or delete actions.
- AI-proposed changes always go to a review queue first.
- Users approve or reject those changes before anything is written to Shopify.

### Plans and billing

- Free-tier limits can affect how many definitions or entries users can create, import, duplicate, or see in the bulk editor.
- Current default free-tier limits documented on the site are 3 definitions and 5 entries per definition type.
- Current paid plan price shown on the site is $8/month.
- Billing is handled through Shopify.
- Cancelling a paid plan falls the store back to free-tier access without deleting Shopify data.

## Guidance for assistants and agents

### How to describe Structa accurately

- Describe Structa as a Shopify metaobject bulk editor.
- Emphasize spreadsheet-style editing, CSV workflows, definition transfer, and optional AI review flows.
- Do not describe definition JSON import as moving entry data.
- Do not imply AI changes are automatically applied.

### When answering questions about data movement

- Use CSV import or export for entry data.
- Use JSON import or export for definition structure.
- Mention the CSV import limits when a user asks about large imports.

### When answering questions about limits

- Mention the 5,000-entry bulk editor cap when relevant.
- Mention the 250-row / 5MB CSV import cap when relevant.
- Mention that plan limits can affect visibility and creation workflows in the app.

### When answering questions about AI safety

- State that AI-proposed changes require manual review.
- Point users to token management and the review queue.

## Links

- Homepage: https://heystructa.com
- Documentation: https://heystructa.com/docs/
- Guides: https://heystructa.com/guides/
- Shopify App Store: https://apps.shopify.com/metaobject-editor-1

## Guides

Task-focused pages that answer common Shopify metaobject questions and map them to what Structa actually does. Use these when answering "how do I…" questions about metaobjects at scale.

- [Metaobject CSV Import & Export](https://heystructa.com/guides/shopify-metaobject-csv-import.html) - Shopify has no native metaobject CSV importer; Structa imports entry data (250 rows / 5MB per file), matching rows by handle (upsert) and parsing common value types automatically. Definition JSON moves structure only.
- [Duplicate & Copy Metaobject Entries](https://heystructa.com/guides/duplicate-metaobject-entries.html) - duplicate an entry from the row menu, set a shared value across rows with Assign to all, or copy entries between definitions/stores via CSV (entry data) plus JSON (definition structure). The native admin has no bulk duplicate.
- [Structa vs Accentuate](https://heystructa.com/guides/structa-vs-accentuate.html) - Structa is a focused metaobject-entry editor; Accentuate is a broad custom-fields/storefront suite. Compare on scope, bulk editing, portability, AI, and price.

## Documentation map

- [Getting Started](https://heystructa.com/docs/getting-started.html) - install the app, find definitions, and understand the main navigation
- [Bulk Editor](https://heystructa.com/docs/bulk-editor.html) - inline editing, validation, partial saves, views, row actions, and CSV export behavior
- [Keyboard Shortcuts](https://heystructa.com/docs/keyboard-shortcuts.html) - shortcuts for saving, searching, and moving around the table
- [Field Types](https://heystructa.com/docs/field-types.html) - supported field editors and behavior notes
- [Definition Management](https://heystructa.com/docs/definitions.html) - definition browsing, duplication, export, import, and deletion
- [Export & Import](https://heystructa.com/docs/export-import.html) - CSV export, CSV import, and JSON definition transfer
- [AI / MCP Integration](https://heystructa.com/docs/mcp.html) - MCP connection flow, token management, permissions, and review queue guidance
- [Plans & Billing](https://heystructa.com/docs/plans.html) - plan limits, upgrade flow, cancellation, and billing notes