Microcopy Fixer
← Back to Dashboard

How to Use Microcopy Fixer

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

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

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.

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. Click "Create"

You can create multiple projects to organize different applications or features separately.

2. Screens

A screen represents a specific page or view in your application. Screens help you organize copy blocks by where they appear in your UI. For example, you might have screens like "Login Page", "Checkout Flow", or "Error Messages".

Creating a Screen

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

💡 Tip: Screens are like containers for UI elements. Blocks inside a screen are like the individual text elements (buttons, labels, messages) that appear on that page.

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)

Creating a Copy Block

  1. Select a screen 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
  4. Click "Add Block"

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

Example CSV:

key,type,originalText
submit-button,BUTTON,Submit
error-invalid-email,ERROR,Please enter a valid email address
welcome-heading,H1,Welcome to our platform
  1. Prepare your CSV file with the required columns
  2. Select a screen from the left sidebar
  3. Click "Bulk Import CSV" in the screen header
  4. Select your CSV file
  5. The blocks will be imported automatically

⚠️ Note: The text column can be named "originalText" or any column name containing "text" or "original" (case-insensitive).

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

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 format for use in other tools or for backup purposes.

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

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

8. 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 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