Articles on: Troubleshooting

Import Settings Fails

Problem:


Importing visual settings shows an error.


Error Message

Cause

Solution

"Invalid settings format"

The pasted JSON is not a valid visual settings export

Make sure you're pasting a JSON file that was exported from this app using the "Export settings" button

"Invalid settings: missing required variants"

The JSON is missing one or more required variant keys

The JSON must include all 4 variants: product_page_desktop, product_page_mobile, product_card_desktop, product_card_mobile

"Failed to parse settings JSON"

The pasted text is not valid JSON

Check for syntax errors such as missing quotes, brackets, or commas


Note:


Exports are forward-compatible. If a settings file was created before a new setting was introduced, the import will still work. Any missing settings will automatically fall back to default values.

Updated on: 16/02/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!