Most of the time a suggestion goes in when you press Apply or Approve. When it does not, the card or a short message says why. Find what you see in the table, then read the part about it below. Review AI changes before they land covers the cards when everything works.
Find what you see
| What you see | What it means |
|---|---|
| This line changed after the suggestion was made. Ask for a new one. | You edited the line after the suggestion was written |
| This line was deleted after the suggestion was made., or the same message for a section | You deleted it after the suggestion was written |
| A line on an older card reads Expired | A newer request in the same chat closed it |
| A line reads Unchanged, with a dice icon | The suggestion matched your line word for word |
| A message that starts Apply failed or Undo failed | The suggestion was no longer in the state the card showed |
| Needs review on a Rewrite preview card | Approving did not go through |
| No card at all | The AI is still working, failed, or found nothing to change |
The line changed after the suggestion
A suggested rewrite remembers how its line read when the suggestion was written. When you press Apply, Heho compares that text with the line as it reads now. If you changed the line since, nothing is written, your edit stays, and the message appears.
With Apply section or Apply all, the lines that still match go in, and the changed ones stay on the card, still waiting. Dismiss those, or ask the Lyrics Assistant again about the new wording. If a line already reads exactly like the suggestion, Apply marks it applied with no message.
If you deleted the line since, Apply writes nothing and the message reads This line was deleted after the suggestion was made. A suggestion for a section you deleted gets This section was deleted after the suggestion was made. The suggestion stays on the card. Dismiss it.
Expired lines on an older card
Each request to the Lyrics Assistant replaces the card before it. When the new card arrives, every suggestion you had not applied in that chat turns Expired and loses its buttons. Lines you had applied stay in the song and keep their Undo.
To use an expired suggestion, ask for it again.
Unchanged lines
Sometimes the Lyrics Assistant suggests the line you already have. The card marks it Unchanged and offers the dice, Try another version, which asks for a new take on that line. Apply all skips unchanged lines.
Apply failed or Undo failed
A message that starts Apply failed means the suggestion had already been applied, dismissed or closed, for example from another tab open on the same song. Undo failed means the same for an applied line that was already undone. Reload the song: the card comes back as it really is, and its buttons work again.
Undo puts back the text the line had just before you applied the suggestion. The suggestion then waits again, with Apply, Retry and Dismiss.
WarningUndo does not look for later edits. If you changed an applied line by hand, Undo replaces your edit with the old text.
Retry and Try another version
Both ask for a new take on one line. A message that starts Retry failed means none came back, and the old suggestion stays on the card. On the free plan, each one uses one of the month's premium previews. When they run out, the upgrade dialog opens instead: Fix an AI action that will not run explains it.
Needs review on a Rewrite preview card
When approving a Rewrite preview does not go through, the card shows Needs review, the reason in red, and a Retry button that tries the approval again.
If the reason is Rewrite preview not found or expired, Retry will not help. The server keeps a preview for a limited time, but an unanswered card comes back after a reload for up to a day, so an old card can outlive its preview. Ask for the rewrite again.
When no card appears
Look at the section first. Working in its header means the AI is still on it, and the card arrives when it ends. Follow AI work while it runs covers the pill at the top right and what a reload does to a running job.
A rewrite or a meter fix that finds nothing to change ends with The AI could not generate changes. Try again or rephrase your request. One that fails shows its reason in red in the Lyrics Assistant panel, where Generating... was, and the bell lists it as failed. Run it again.
A request your plan or balance does not cover opens the upgrade dialog instead of a card.
