Documentation
Importing and exporting
Exporting gives you a portable copy of selected Akurium collections. Importing can restore an Akurium package or bring it into another account while preserving its catalog structure.
Import and export availability depends on your plan. Visit Plans for the current comparison.
Open the import and export tools
Section titled “Open the import and export tools”Open your account menu, select Account & Settings, and expand Export / Import.
The section contains two separate tools:
- Export Collections creates a downloadable JSON file or ZIP package.
- Import JSON or ZIP reads a package previously created by Akurium.
Export collections
Section titled “Export collections”Select Export Collections, then choose one or more collections. All of your collections are selected by default; use Select all or Deselect all to adjust the list quickly.
Choose whether to include images:
- With Include images turned off, Akurium downloads
akurium-export.json. It contains structured catalog data and references to image paths, but not the image files themselves. - With Include images turned on, Akurium creates a ZIP package containing
akurium-export.jsonplus available collection covers and item gallery images.
The structured export includes the selected collections and their items, along with relevant themes, categories, attribute definitions and values, visibility, status, audience classifications, favorites, and following information.
Use the ZIP option when preserving photographs matters. A JSON-only export is useful for catalog data, but it cannot independently restore image files that are no longer available to Akurium.
Store exports safely
Section titled “Store exports safely”An export may contain private or unpublished collection information. Treat the downloaded file as personal data even though it does not include your password.
Useful backup habits include:
- Keep exports in a location you control.
- Use the date in the filename or containing folder.
- Keep more than one generation instead of continually replacing the same file.
- Open ZIP packages occasionally and confirm that they contain
akurium-export.jsonand anassetsdirectory. - Create a fresh export before a large import, account cleanup, or plan downgrade.
Import an Akurium package
Section titled “Import an Akurium package”In Account & Settings, expand Export / Import and upload either:
- An
akurium-export.jsonfile created by Akurium, or - An Akurium ZIP package containing the JSON file and bundled images
After Akurium reads the package, select the collections you want to import. All collections in the package are selected by default.
The preview summarizes themes, categories, attribute groups, definitions, collections, items, favorites, follows, and important warnings. Review warnings before continuing.
Preserve or adjust slugs
Section titled “Preserve or adjust slugs”The import actions include Preserve slugs. Slugs are the URL-friendly identifiers derived from names.
Enable this option when retaining the original slug matters. If it conflicts with an existing record, Akurium can append a number to avoid a duplicate. Leave it off when you are comfortable allowing Akurium to resolve imported slugs for the destination account.
Run the import
Section titled “Run the import”When the preview looks correct:
- Confirm the collections selected for import.
- Choose whether to preserve slugs.
- Select Run import.
- Confirm the action.
- Read the completion summary and any warnings.
Imported collections and items are set to Draft, including records that were published in the source package. This gives you a chance to review names, images, attributes, audience settings, and visibility before making anything public.
Existing records and repeated imports
Section titled “Existing records and repeated imports”Akurium uses stable identifiers in its export packages to recognize material it has seen before. When a matching collection or item already exists, an import may update it rather than creating a duplicate.
Always preview a repeated import. Create a fresh export first when the destination account contains changes you cannot easily recreate.
How plan limits affect imports
Section titled “How plan limits affect imports”Your current plan limits are enforced during import:
- Collections beyond your available collection limit, along with their associated items, may be skipped.
- Item limits can cause imported items to be restored as metadata-only drafts without their images.
- Images beyond the per-item limit may be skipped.
- Missing files in an image package produce warnings and may leave affected images unavailable.
Import warnings identify these conditions. A completed import can therefore contain fewer collections, items, or images than the source package when the destination plan has lower limits.
Review imported material
Section titled “Review imported material”After importing, open Manage Your Collections and inspect each imported collection before publishing it. Pay particular attention to:
- Collection and item visibility
- The required item audience setting
- Cover and gallery images
- Item attributes
- Names and URLs
- Warnings reported during preview or import
Publishing remains a separate, deliberate step after the import is complete.