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. Clicking Try to fix doesn’t use credits. 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:1
Ask Lovable to investigate
Describe what you see and what you expected. Lovable can inspect errors, logs, and console output, and test your app in a browser.
2
Revert and re-prompt
Roll back to the version just before the issue appeared using version history, then try a clearer, more specific prompt.
3
Plan before rebuilding
Switch to Plan mode and ask Lovable to outline an approach first. Review the plan, adjust it, then build step by step.
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?
Yes. Messages in both Build and Plan mode consume credits. You can see what a specific message cost from its More options menu under Credits used. See Credits and usage.
Can I send several instructions at once?
Can I send several instructions at once?
Yes. While Lovable is working, keep typing: new messages go into a queue and run one at a time, in order. You can pause, reorder, edit, or remove queued messages before they run. See Build mode.
How do I undo what the last message did?
How do I undo what the last message did?
Click Undo latest edit under Lovable’s latest response to reverse its most recent change in one click. To go further back, revert from version history, or use Edit message on your own message and choose Revert and resend to rewrite it and try again.
How do I attach images and files?
How do I attach images and files?
Use Attach in the Chat actions menu, drag files into the chat, or paste them. You can also use Take a screenshot to capture the preview. See Attach files as context.
Can I edit the code directly instead of using chat?
Can I edit the code directly instead of using chat?
Yes. Open the Code tab in the project toolbar to read and edit your project’s code by hand. See Edit code.
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"?
Single files larger than 10 MB cannot be saved into your project’s code, usually after adding large images, videos, or other media. Ask Lovable in chat to migrate them, and it moves the files to Lovable’s CDN and updates your code to load them from there:Files pushed from your own computer through GitHub or GitLab can be larger, but Lovable cannot change them afterwards.
What happens if I close my browser while Lovable is working?
What happens if I close my browser while Lovable is working?
Lovable keeps working. Your request runs on Lovable’s servers, not in your browser, so you can close the tab and come back later to find the finished result in chat.
Can Lovable notify me when it's done?
Can Lovable notify me when it's done?
Yes. On desktop, Lovable may offer to enable browser notifications so you know when it finishes a task or needs your input. You can dismiss the prompt and keep working without them.