Skip to content
  • There are no suggestions because the search field is empty.

AI Wizard - Custom Prompt (Tone by Prompt)

Get full control over copy rewrites in the Visual Editor with Custom Prompt. Instead of picking a pre-set tone/model, you can now type any instruction (prompt) and generate suggestions tailored to it.

Author: Dionysia Kontotasiou
Last Updated: October 1, 2024

 

IN THIS ARTICLE YOU WILL:

What you can do

  • Pick “Custom Prompt” in the AI Wizard dropdown.

  • Type your own instruction (e.g., “Make this sound friendlier and fun for a younger audience.”).

  • Generate suggestions based on your prompt.

  • Replace only the selected text—the selection behavior is identical to the other AI Wizard rewrite styles.

Background: AI Wizard has existed since 2023 to provide quick recommendations in the editor. 

How to use it (UI steps)

  1. Open your Experience (A/B test or Deploy) and launch the Visual Editor.

  2. Select the text on the page you want to rewrite.

  3. Switch to the AI Wizard tab in the left panel.
    1-1

  4. Open Rewrite Style and choose Custom Prompt.
    2-1

  5. In Write Your Prompt, type the instruction/tone you want (examples below).

  6. Click Generate Text to see several options.
    5-1

  7. Click an option to apply it.

  8. Save Element Changes when you’re happy.

Examples of useful prompts

  • “Shorten this to a 1-line headline in plain language.”

  • “Make this persuasive for first-time visitors using social proof.”

  • “Rewrite in a playful, Gen Z voice—keep the CTA.”

  • “Translate to Spanish, but keep brand names in English.”

How it works (under the hood)

  • In classic modes (e.g., AIDA → Interest), the UI sends principle_class: "aida" and principle: "interest" in the request payload to the AI text endpoint (as shown in the dev tools screenshot).

  • Custom Prompt changes this behavior:

    • The request sets principle_class: "none" (so no built-in framework is enforced).

    • Your typed instruction is sent as context for the model via context_content and is appended to the backend prompt.

    • This gives you flexibility while mitigating prompt-abuse risk—you do not control the entire system prompt.

API & product scope reference: AI content endpoints and REST v2 overview.

Convert API Documentation Overview

API notes (for developers)

If you’re testing or integrating the same generation flow outside the editor:

Endpoint
Use the AI content/text generation endpoint under the REST v2 scope (see API overview for auth and paths).

Payload pattern

{
  "content": "<<<selected-text-from-editor-or-supplied-string>>>",
  "parameters": {
    "variationsNumber": 3
  },
  "principle_class": "none",
  "context_content": "Make this sound more friendly and fun for a younger audience."
}

  • Set principle_class: "none" for Custom Prompt behavior.

  • Omit principle when principle_class is "none".

  • Provide your instruction in context_content.

  • Keep content as the current text you want to rewrite (the editor auto-fills this from the selection).

  • variationsNumber controls how many suggestions to return.

Backward compatibility
Predefined frameworks still work the same way:

{
  "content": "<<<selected-text>>>",
  "parameters": { "variationsNumber": 3 },
  "principle_class": "aida",
  "principle": "interest"
}

(That structure matches what you’ll see in your browser network tab when using AIDA → Interest.)

Permissions & safety

  • Custom Prompt does not expose or allow editing of the underlying system prompt.

  • It adds your instruction as additional context only.

  • The editor continues to require a text selection—you’re not rewriting the entire page in one go.

Troubleshooting

I don’t see “Custom Prompt”

  • Make sure you’re on the latest app version and your account has AI Wizard enabled.

Nothing happens when I click Generate

  • Ensure you have selected text on the canvas first. The AI Wizard only rewrites selected content.

  • If you’re testing in a restrictive environment (e.g., content-security policies), verify that the app can reach Convert’s AI endpoints.

The result isn’t in the tone I expected

  • Adjust your instruction to be more concrete (e.g., “rewrite to approachable, 8th-grade reading level; keep CTA ‘Start Free Trial’ intact; max 12 words”).

  • Generate again to get new alternatives.

FAQ

Does Custom Prompt replace the existing tone frameworks (AIDA, PAS, FAB, etc.)?
No. It adds a flexible option. You can still use preset frameworks anytime.

Can I use Custom Prompt on Deploys?
Yes—anywhere the Visual Editor AI Wizard appears (Experiences or Deploys).
Source (feature context): What’s New – June 2025