Troubleshooting
Something not working as expected? Find your problem below and follow the solution.
Conversion Problems
The preview is blank
Possible causes:
- The HTML code is empty or contains only comments
- The HTML is malformed (unclosed tags)
Solution: Verify that your HTML code contains visible elements. Try with a simple <div>Hello</div> to test.
Styles are missing after conversion
Possible causes:
- The CSS was not pasted in the CSS tab
- The CSS uses selectors that do not match the HTML (typos in class names)
Solution: Verify that the CSS is in the CSS tab (not in the HTML tab). Check that class names match between the HTML and CSS.
The layout is different from the preview
Possible causes:
- You are not at the Desktop breakpoint in Webflow
- Existing classes in your Webflow project have the same name and create conflicts
Solution: Make sure you are at the Desktop breakpoint in Webflow Designer. If you are adding content to an existing project, use reference styles to avoid conflicts.
Pasting Problems in Webflow
Nothing happens when I paste
Possible causes:
- No element is selected in the Webflow Navigator
- Your browser does not properly support the advanced copy function used by Convertex
Solution: In Webflow Designer, open the Navigator panel (on the left) and click on Body or the section where you want to insert the content. Then press Cmd+V again.
If the problem persists, use a modern, up-to-date browser such as Google Chrome, Microsoft Edge, or Brave. Some browsers (especially older versions or alternative browsers) do not properly support the Clipboard API used to copy in Webflow format.
Fonts do not match
Cause: The font used in the code is not available in your Webflow project.
Solution: In Webflow, go to Project Settings > Fonts and add the missing font (Google Fonts, Adobe Fonts, or custom upload).
Images are not displaying
Cause: Images use local paths (images/photo.jpg) instead of full URLs.
Solution: Replace image paths with absolute URLs before converting, or upload the images in Webflow and replace the sources after pasting.
AI Problems (Claude)
Claude does not generate Webflow code
Possible causes:
- The word "Convertex" is not in your prompt
- The Skills are not installed
- You did not start a new conversation
Solution: Start your prompt with "With Convertex, ..." to activate the Skills. If that does not work, verify that the Skills are installed and start a new conversation.
Claude generates code but does not send it to Convertex
Possible causes:
- The MCP is not connected
- The API key has expired or is invalid
Solution: Ask Claude "Test the Convertex connection". If it cannot connect, check your MCP configuration. Generate a new API key if needed.
Convertex tools do not appear in Claude
Possible causes:
- The API key is incorrect (must start with
cvx_) - The JSON configuration has a syntax error
- The application was not restarted after configuration
Solution:
- Check your API key in your Convertex account settings
- Validate your JSON at jsonlint.com if you configured manually
- Fully restart your Claude application (quit and reopen)
Claude asks me the 3 questions every time
This is normal. Claude asks these questions (Client-First?, rem/px?, language?) at the beginning of each new conversation. To avoid them, include the answers in your prompt: "With Convertex, free naming, in px, content in English, ..."
Chrome Extension Problems
The extension does not capture anything
Possible causes:
- The site uses protections against code extraction
- The content is loaded dynamically after initial page load
Solution: Wait for the page to fully load before capturing. If the problem persists, some sites actively protect their code. Try with another site to verify the extension works.
The capture is incomplete
Cause: The selected section depends on styles defined elsewhere on the page (in a parent, in the <head>, etc.).
Solution: The extension captures the computed styles of the section, which should include all inherited styles. If styles are missing, try selecting a wider parent element.
Account Problems
I am not receiving the Magic Link
Possible causes:
- The email is in spam
- The email address has a typo
Solution: Check your spam/junk folder. Try again, carefully verifying the email address. The link is valid for 10 minutes.
My conversion counter is not resetting
Cause: The counter resets on the anniversary date of your registration, not on the first of the month.
Solution: Check the reset date in your account settings (displayed in the dashboard).
Still Stuck?
If your problem is not listed here:
- Click "Report a problem?" in the Convertex editor (next to the Convert button). Your feedback directly helps us improve the tool.
- Contact support at hello@convertex.ai.