Import & Export Settings

Copymarky lets you save all your settings to a file and restore them anywhere. This guide explains how to export, import, and share your configuration.

Export Settings

Where to Find Export

1. Open Copymarky (popup or sidepanel)
2. Look for the “Export Settings” button (usually in a menu or options area)
3. Click it

What Gets Exported

The export file (copymarky-settings.json) includes:

• All formatting preferences (heading style, bullet markers, code block style, link style, image handling)
• Output options (include page title, include source URL)
• All text replacement rules (patterns, replacements, enabled state)
• Any other custom preferences

Save the File

• Your browser prompts you to save the file to your computer
• The file is named copymarky-settings.json by default
• Save it somewhere safe and accessible (Downloads folder, cloud storage, password manager notes, etc.)

File Size

The settings file is small (typically under 100 KB) and is plain JSON text.

---

Import Settings

Where to Find Import

1. Open Copymarky (popup or sidepanel)
2. Look for the “Import Settings” button (usually in a menu or options area)
3. Click it

Steps

1. Click “Import Settings”
2. Choose the copymarky-settings.json file from your computer
3. Confirm the import (if Copymarky shows a confirmation dialog)
4. Your settings are now restored

What Happens on Import

Adding New Settings: Any formatting options or text replacement rules from the file are added to Copymarky.

Updating Existing Settings: If you already have a setting configured, the imported value overrides it.

Preserving Untouched Settings: Settings you haven’t customized are left as-is (not overwritten with defaults).

Error Handling

If the import fails:

• File is invalid JSON: Check that the file is a valid copymarky-settings.json created by Copymarky export. Don’t edit it manually unless you understand the JSON structure.
• File is corrupted: Try exporting settings again and re-importing.
• Wrong file: Ensure you’re selecting the correct settings file.

Copymarky will show an error message describing what went wrong.

---

Use Cases

Backup Your Settings

Export your settings regularly to protect against browser crashes or accidental resets.

Workflow:

1. Export settings after making significant changes
2. Store the file in cloud storage (Google Drive, Dropbox, iCloud, etc.)
3. If you reinstall your browser or extension, import the file to restore everything

Sync Across Devices

Use exported settings to keep Copymarky consistent on multiple devices.

Workflow:

1. Export settings from Device A
2. Share the file or store it in cloud storage
3. On Device B, import the file
4. Both devices now have identical formatting and text replacement rules

Share with Teammates

Share your text replacement rules with coworkers or the community.

Workflow:

1. Export settings
2. Share the copymarky-settings.json file via email, Slack, GitHub, or cloud storage
3. Teammates import the file
4. Everyone now has your optimized rules

Version Control

Store your settings in Git for team collaboration.

Workflow:

1. Export settings
2. Commit copymarky-settings.json to a repository
3. Teammates clone the repo and import the file
4. Easy to track changes and roll back if needed

---

Safety & Best Practices

Regular Backups

Export your settings after:

• Adding new text replacement rules
• Changing formatting preferences
• Making significant customizations

Consider exporting monthly or after major changes.

Secure Storage

• Store JSON files with sensitive information in a password manager or encrypted storage
• Don’t leave them in unencrypted downloads folders
• Don’t share settings files publicly if they contain private patterns

Review Before Importing

When importing settings from an untrusted source:

1. Check the file: Open the JSON in a text editor and review the rules
2. Look for suspicious patterns: Watch for rules that remove unexpected content
3. Test in a private window: Import and test on a test webpage before relying on it
4. Start small: Import on one device first, then sync to others after confirming it works

Don’t Edit JSON Directly

The copymarky-settings.json file uses a specific structure. Editing it by hand can corrupt the file.

Only edit the JSON if you:

• Understand JSON syntax
• Are familiar with Copymarky’s settings format (see Text Replacement Rules Reference)
• Have a backup of the original file

Otherwise, use the UI to add, edit, or delete rules.

Format Compatibility

The export format is stable, but future Copymarky versions might introduce new settings. Importing old settings into new versions works fine; new settings use defaults.

---

Troubleshooting

”File is invalid” Error

• Ensure the file is named copymarky-settings.json
• Check that it’s valid JSON (open in a text editor to verify)
• Don’t rename or edit the file outside of Copymarky
• Try exporting again and re-importing

Settings Aren’t Updating

• Confirm the import completed without errors
• Refresh the page or restart the browser extension
• Check the Copymarky UI to verify settings changed

Imported Rules Don’t Seem to Work

• Ensure the rules are enabled (check the toggle in the Replace tab)
• Review the rule order (rules apply top-to-bottom)
• Test the regex on a simple page
• See Text Replacements for debugging tips

Lost Your Settings File

Unfortunately, Copymarky doesn’t have cloud sync. If you lose your settings:

• You’ll need to manually recreate them
• Prevent this by exporting and storing backups regularly

---

Next Steps

• Text Replacements — Create custom rules to share
• Settings Reference — Understand the settings structure
• Text Replacement Rules Reference — Detailed rule field documentation