Microcopy Fixer
← Back to Dashboard

How to Use Microcopy Fixer

A comprehensive guide to improving your UI microcopy with AI-powered suggestions

Works with ChatGPT and LLMs

You can call Microcopy Fixer from LLM agents using API keys. Common tasks include rewriting microcopy blocks, generating captions, and running bulk imports.

Quick API example

curl -X POST https://microcopyfixer.com/api/copyblocks/rewrite \
  -H "Content-Type: application/json" \
  -d '{"text":"Update your settings","tone":"concise","language":"en"}'

See the full API spec: /.well-known/openapi.json

Overview

Microcopy Fixer is an AI-powered tool that helps you improve the clarity, accessibility, and effectiveness of your user interface text. Organize your copy into projects, screens, and blocks, then use AI to generate better alternatives and compare versions.

1. Projects & Brand Voice

A project is the top-level container for all your microcopy work. Think of it as a workspace for a specific application, website, or feature set. Each project can have its own brand voice settings to ensure all AI rewrites match your unique tone and style.

Creating a Project

  1. Go to your Dashboard
  2. Click the "+ New Project" button
  3. Enter a project name (e.g., "E-commerce App", "Login Flow")
  4. Select a tone preset: Professional, Friendly, Casual, Playful, or Custom Brand Voice
  5. For Custom Brand Voice:
    • Paste or upload your brand guidelines (PDF, TXT, or MD)
    • Optionally expand Advanced: Customize Voice Attributes to fine-tune:
      • Formality level (casual → professional)
      • Confidence level (tentative → assertive)
      • Empathy level (neutral → warm)
      • Complexity level (simple → technical)
      • Target reading grade (6-12)
      • Voice adjectives (e.g., clear, approachable, concise)
      • Prohibited phrases to avoid
  6. Click "Create Project"

✨ Custom Brand Voice: When you select "Custom Brand Voice," all AI rewrites in this project will automatically follow your brand guidelines and voice attributes. You can edit these settings anytime in Project Settings → Brand Voice.

You can create multiple projects to organize different applications or features separately, each with its own brand voice configuration.

2. Screens / Folders

A screen / folder represents a grouping for captions — a specific page, view, or logical folder in your project. Screens/folders help you organize copy blocks by where they appear or how you plan campaigns. For example, you might have screens/folders like "Login Page", "Checkout Flow", or "Holiday Campaign".

Creating a Screen / Folder

  1. Open a project from your Dashboard
  2. In the left sidebar, click "+ Add Screen / Folder"
  3. Enter a descriptive screen / folder name (e.g., "Login Page", "Settings Modal", "Holiday Campaign")
  4. Click "Add"

💡 Tip: Like folders — group captions by campaign, channel, or page. Blocks inside a screen/folder are the individual text elements (buttons, labels, messages) that appear on that page or within that campaign.

3. Copy Blocks

A copy block is a single piece of text in your UI. This could be a button label, error message, help text, heading, or any other microcopy element. Each block has:

  • Key: A unique identifier (e.g., "submit-button", "error-invalid-email")
  • Type: The element type (Button, Error, Help, Heading, Label, etc.)
  • Original Text: The current text in your UI
  • Current Text: The improved version (if you've applied changes)
  • Context (optional): Additional information to help AI understand where/how the text is used
  • Max Characters (optional): Character limit for AI rewrites and CSV bulk imports

Creating a Copy Block

  1. Select a screen/folder from the left sidebar
  2. Click "+ Add Block" in the screen header
  3. Fill in the form:
    • Block Key: A unique identifier (e.g., "submit-button")
    • Type: Select from Button, Error, Help, Heading, Paragraph, Label, Tooltip, or CTA
    • Original Text: Paste or type the current copy
    • Context (optional): Where does this appear? What does the user see before/after?
  4. Click "Add Block"

💡 Tip: Adding context helps generate more precise rewrites. For example: "On signup form beside password input" or "Error shown when email format is invalid."

4. Bulk Import CSV

Instead of adding blocks one by one, you can import multiple blocks at once using a CSV file. This is especially useful when migrating existing copy or working with large sets of text.

CSV Format Requirements

Your CSV file must include these columns:

  • key (required) - Unique identifier for each block
  • type (optional) - Block type (defaults to BUTTON if not provided)
  • originalText (required) - The original copy text
  • context (optional) - Additional context for AI (e.g., "signup form", "error state")
  • maxChars (optional) - Character limit for AI rewrites (e.g., 20 for mobile buttons)

Example CSV:

key,type,originalText,context,maxChars
submit-button,BUTTON,Submit,login form,15
error-invalid-email,ERROR,Please enter a valid email address,form validation,50
welcome-heading,H1,Welcome to our platform,homepage hero,25
  1. Prepare your CSV file with the required columns
  2. Select a screen/folder from the left sidebar
  3. Click "📥 Bulk Import CSV" in the screen header
  4. Click the "?" button next to it for help and to download a CSV template
  5. Select your CSV file
  6. Review the import preview and validate your data
  7. Optionally use "Bulk Rewrite" to apply AI improvements to all imported blocks at once

💡 Tip: Use maxChars for buttons/labels with strict length requirements. Add context to help AI understand placement and user intent.

⚠️ Note: The text column can be named "originalText" or any column name containing "text" or "original" (case-insensitive). Character limits apply to AI rewrites and CSV bulk imports.

5. Editing and Improving Copy

Click on any copy block to open the Editor Modal, where you can use AI to improve your text. The editor provides powerful tools for refining your microcopy.

Tone Presets

Before generating improvements, select a tone preset that matches your brand voice:

  • Professional: Formal, business-appropriate tone
  • Friendly: Warm, approachable, conversational
  • Casual: Relaxed, informal language
  • Technical: Precise, industry-specific terminology

AI Improvement Actions

Click any of these buttons to generate AI-powered improvements:

Improve Clarity

Makes text clearer and easier to understand

Shorten

Reduces length while keeping meaning

Make Action-Oriented

Emphasizes user actions and outcomes

Fix Accessibility

Improves accessibility and inclusivity

Make Friendly

Adds warmth and friendliness

Make Professional

Adopts a more formal, business tone

Match Brand Voice

Rewrites to match your project's custom brand voice settings

✨ Brand Voice Magic: If your project has Custom Brand Voice configured, use the "Match Brand Voice" action to rewrite copy that strictly follows your brand guidelines and voice attributes.

Understanding the Results

After generating improvements, you'll see:

  • Primary Rewrite: The main AI-suggested improvement
  • Alternatives: Additional options to compare (A/B testing candidates)
  • Reasons & Feedback: Explanation of why the changes were made
  • Readability Metrics: Flesch-Kincaid score showing reading difficulty
  • Length Comparison: Character count changes

A/B Comparison

Compare different versions side-by-side to make informed decisions:

  1. Click "A/B Compare" on any rewrite or alternative
  2. View detailed metrics for both versions
  3. Read the AI analysis explaining strengths and weaknesses
  4. Choose the winner that best fits your needs

Applying Changes

Once you've found a version you like:

  • Click "Apply Primary" or "Apply Selected Alternative"
  • The change is saved as the "Current Text" for that block
  • All changes are tracked in version history

6. Version History

Every change you make is automatically saved to the block's version history. This allows you to:

  • Review all previous versions of a block
  • Restore a previous version if needed
  • Track when changes were made
  • See notes associated with each version

To restore a previous version, click on it in the version history section of the Editor Modal.

7. Exporting Your Work

Export your copy blocks to CSV or JSON format for use in other tools, developer handoff, or backup purposes.

CSV Export

  1. Select a screen/folder from the left sidebar
  2. Click "📤 Export" in the screen header
  3. A CSV file will download with all blocks from that screen/folder

The exported CSV includes: key, type, originalText, and currentText columns.

JSON Export (with Context)

  1. Select a screen/folder from the left sidebar
  2. Click "📄 Export JSON" in the screen header
  3. Optionally check "Include diffs" to see word-level changes between original and current text
  4. A JSON file will download with complete block data including context

JSON export is ideal for developer handoff as it includes context, metadata, and optional diff information.

8. Inline Editing & Character Limits

For quick edits without opening the full editor modal, you can use inline editing directly on copy blocks.

Using Inline Editing

  1. Click the "Edit" button on any copy block
  2. Edit the text directly in the textarea
  3. Optionally set a max characters limit to constrain AI rewrites and bulk imports
  4. Click "✅ Save" to apply changes

Changes are saved with an "Inline edit" note in the version history. You can undo changes within 7 seconds using the toast notification.

💡 Character Limits: Setting a max characters value ensures AI won't suggest rewrites that exceed your UI constraints (useful for mobile buttons, tooltips, etc.).

9. Filtering, Search & Organization

Manage large sets of copy blocks efficiently with built-in filtering and search tools.

Search Blocks

Use the search bar above your copy blocks to filter by key, type, or text content. Search is debounced for smooth typing.

Filter by Applied State

Filter blocks by their state:

  • All: Shows all copy blocks
  • Applied: Blocks that have been rewritten by AI, Extension, Bulk, or Captions
  • Unapplied: Blocks that haven't been modified yet

Sort & Pagination

Sort blocks by newest or oldest. Adjust items per page (10, 15, 20, or 50) to manage large screen/folder views efficiently.

Applied Source Labels

Badges show how each block was modified:

  • ✨ Applied from AI: Rewritten in the editor
  • ✨ Applied from Bulk: AI rewrite via CSV bulk job
  • ✨ Applied from Extension: Modified via Chrome extension
  • ✨ Applied from Captions: Applied from Social Captions tool

You can toggle these labels on/off using the "👁️ Show/Hide Applied Source Labels" button.

10. Chrome Extension Integration

Install the Microcopy Fixer Chrome Extension to rewrite copy directly on any webpage without leaving your browser.

Using the Extension

  1. Install the extension from the Chrome Web Store
  2. Sign in with your Microcopy Fixer account
  3. Select any text on a webpage
  4. Click the extension icon or use the context menu
  5. Choose a project and generate AI rewrites
  6. Apply changes and sync them back to your project

✓ Real-time Sync: Changes made in the extension automatically appear in your project workspace with an "Applied from Extension" badge.

11. Social Captions Optimizer

Generate and optimize social media captions for platforms like Instagram, Twitter, LinkedIn, and Facebook.

Using Social Captions

  1. Navigate to Tools → Social Captions from the header
  2. Select a project (optional - uses project's brand voice if configured)
  3. Choose a platform or leave as "General"
  4. Enter your content description or draft caption
  5. Click "Generate Captions"
  6. Review AI-generated options with emoji suggestions
  7. Copy your favorite caption or save it to a project screen/folder

✨ Brand Voice Integration: When you select a project with Custom Brand Voice, captions automatically match your brand guidelines and tone.

12. Best Practices

Organize by User Flow

Create screens that match your user journeys. For example, "Sign Up Flow" or "Checkout Process" help you see all related copy in one place.

Use Descriptive Keys

Choose clear, consistent naming for block keys (e.g., "submit-button", "error-invalid-email"). This makes it easier to find and reference blocks later.

Compare Before Applying

Always use the A/B comparison feature to evaluate different versions. The AI analysis provides valuable insights into why one version might be better than another.

Test Different Tones

Experiment with different tone presets to see which voice works best for your audience. You can generate multiple versions and compare them.

Need Help?

If you encounter any issues or have questions:

  • Check that your CSV files have the required columns (key, type, originalText)
  • Ensure you've selected a screen/folder before adding blocks or importing
  • Review the tooltips on buttons for quick guidance
  • Make sure you're connected to the internet for AI features to work
Go to Dashboard
Microcopy Fixer — On‑Brand AI Microcopy, Captions & UI Copy