The prompt box
Type your message into the text field at the bottom of the chat panel, then press Enter or click the send button. You don’t need any special phrasing. Describe the outcome you want rather than the implementation:- The microphone: Dictate your message instead of typing. Click it to start recording, or press Option+V (Mac) or Alt+V (Windows/Linux). When you finish, click the check, and Lovable transcribes your words into the prompt box for you to review and send. Click the X instead to discard the recording.
- The mode toggle: Switch between Build and Plan mode, or press Option+P (Mac) or Alt+P (Windows/Linux).
- The button: Open the Chat actions menu to attach files, add references, and reach common project tools.
Modes
The mode toggle next to the chat input switches how Lovable responds:- Build: Lovable makes changes directly in your project. This is the default, and the right choice for most requests, from small tweaks to whole features. Cost is usage-based, and many requests cost less than one credit. See Build mode.
- Plan: Lovable discusses, investigates, and plans without touching your code. Use it to think through a bigger feature, debug an issue safely, or compare approaches before building. Each Plan mode message costs one credit. See Plan mode.
Chat actions
Click the button next to the chat input to open the Chat actions menu, the quickest route to attaching context and common project tools:- Settings: Open the settings dialog on your project’s General tab, where you rename the project, manage publishing options, and more. See Project settings.
- History: Open your project’s version history to browse and restore earlier versions.
- Knowledge: Write persistent instructions that Lovable follows in every request, such as your product context or design rules. See Knowledge.
- GitHub: Connect your project to a GitHub repository with two-way sync, so changes flow in both directions. See GitHub.
- GitLab: Connect your project to a GitLab repository with two-way sync, so changes flow in both directions. See GitLab.
- Project connectors: See the services your project is connected to and the chat connectors available to it, and click any connection to manage it. See Connectors.
- Take a screenshot: Capture the current preview and attach it to your message, useful for pointing at what you’re discussing.
- Add reference: Open the
@picker to point Lovable at:- Code: Files in your project’s codebase.
- Files: Documents you uploaded or Lovable generated.
- Connectors: A selection of popular connectors to pull content from.
- Projects: Other projects in your workspace.
- Add skill: Browse your workspace’s skills, reusable instruction sets, and run one. Picking a skill types the
/command for you. - Attach: Add files from your computer to your message. See Attach files as context.
Attach files as context
Attachments show Lovable what you mean. Attach a design mockup to match, a screenshot of a bug to fix, or a document to build from, like a product brief, a spreadsheet of data, or an audio note. Attachments work the same when you create a project from the dashboard: attach files to your very first prompt. To add files, use Attach in the Chat actions menu, drag files into the chat, or paste them. Lovable reads what you attach: images, PDF, Word, Excel, and PowerPoint files, and even audio recordings. Ask questions about an attached document, or tell Lovable to use its content in your app. Each file can be up to 20 MB on the Free plan, 256 MB on paid plans, and 1 GB on Enterprise. You can attach up to 10 files per message. Images can total up to 15 MB per message, and Lovable compresses large ones automatically. If an upload fails, try again with fewer or smaller files. After attaching an image, click it to open the preview and draw on it, for example to circle the part you want changed. Lovable receives the annotated image with your message. To put an image or video into your app itself rather than show it to Lovable, see the next section.Add images and videos to your app
To place media in the app you’re building, use whichever of these fits:-
Ask Lovable to generate it: Lovable can generate images, edit existing ones (including making backgrounds transparent), and even generate short videos. Describe what you want:
-
Attach the image in chat: Upload the image and tell Lovable where it goes:
- Point at an existing image: In the preview, use Select elements in the preview toolbar to select the image you want to change, attach the replacement or paste its URL, and describe the update.
- Reference a hosted URL: If the image already lives somewhere online, paste its URL in chat and tell Lovable where to use it. Be mindful of copyright.
-
Upload to your Git repository: If your project is connected to GitHub or GitLab, upload media files to the repository’s
publicfolder, then reference them by path: - Embed a video: Link to a hosting service like YouTube and ask Lovable to embed it. For example:
While Lovable works
Lovable working on one request doesn’t block you. Here is what you can do in the meantime.Queue your next prompts
You don’t have to wait for Lovable to finish before sending your next request. In both Build and Plan mode, new messages join a visible queue above the chat input and run one at a time, in order. You can pause and resume the queue, reorder prompts, edit, copy, or remove them, and repeat a queued prompt up to 50 times. Queued prompts keep the files, elements, and references you attached to them.Follow the work in activity cards
Lovable’s individual actions show up in chat as expandable activity cards: file edits, commands, web searches, browser tests, and the subagents it delegates research to. Expand a card to inspect the details. On bigger Build mode requests, Lovable also shows the tasks it’s working through. See Build mode.Stop mid-task
If you need to change course, click the stop button while Lovable is responding. Lovable keeps the work completed so far, and the message is charged for the work already done. You can then send a new message with better direction.Answer Lovable’s questions
When Lovable needs more direction, it can pause and show a question card instead of guessing. The card holds up to four questions, each with answer options, and you can pick an option or write your own answer. You stay in control of how much you answer:- Move between questions and change earlier answers before submitting.
- Skip a single question, or skip them all. If you skip everything, Lovable picks reasonable defaults and continues.
- Draft answers are kept in your browser, so refreshing the page doesn’t lose them.
Act on Lovable’s responses
When Lovable finishes a task, its response summarizes what it did and what changed, and a row of actions lets you react without typing:- Undo latest edit (latest response only): Reverse Lovable’s most recent change in one click, with no confirmation.
- Revert to this version (earlier responses): Restore your project to that point after you confirm. Works the same as reverting from version history.
- Copy: Copy the response text, for example to save an explanation Lovable gave you.
- Helpful / Not helpful: Rate the response to give feedback on the result.
- Copy message link: Copy a direct link to that message, handy for pointing a collaborator or support to the exact step where something happened.
- Preview: See your app as it was right after that message, without reverting anything.
- How long Lovable worked and Credits used: What the message cost. See Credits and usage.
Edit a message and try again
If an earlier request sent things the wrong way, hover over one of your own past messages and select Edit message. Rewrite the message and confirm with Revert and resend: your project returns to the state before that message, and Lovable runs the new version instead. This works on your own text-only messages. Learn more in Version history.Fix errors and get unstuck
When a build error appears while Lovable works, a Try to fix button appears on the activity card. Click it and Lovable scans the logs, finds the issue, and attempts a fix. Fixing errors is free within our fair use policy. If you go beyond it, Try to fix runs as a normal chat message and is charged like any other request. If the error keeps coming back, or your app runs without errors but doesn’t behave as you intended, work through these steps instead of retrying the same prompt:Ask Lovable to investigate
Revert and re-prompt
Plan before rebuilding
Suggestions from Lovable
After a response, Lovable may suggest features to build next as clickable chips near the chat input. Click one and it fills the prompt box, so you can adjust the wording before sending, or ignore the chips and write your own. Suggestions are based on your project and what you just built. You can turn them off with the Chat suggestions toggle in your account settings.FAQ
Do chat messages cost credits?
Do chat messages cost credits?
Does Try to fix cost credits?
Does Try to fix cost credits?
Can I send several instructions at once?
Can I send several instructions at once?
How do I undo what the last message did?
How do I undo what the last message did?
How do I attach images and files?
How do I attach images and files?
Can I edit the code directly instead of using chat?
Can I edit the code directly instead of using chat?
Why do I see "The following file(s) exceed the 10 MB per-file commit limit"?
Why do I see "The following file(s) exceed the 10 MB per-file commit limit"?
What happens if I close my browser while Lovable is working?
What happens if I close my browser while Lovable is working?
Can Lovable notify me when it's done?
Can Lovable notify me when it's done?