> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visualradioassist.live/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use the names from the glossary at https://docs.visualradioassist.live/glossary: Audio Manager (two words), command (never commando), on air and off air (never live) for programs and studios, and server apps for the VRA apps installed in the studio.
> Say which app an answer applies to, like VRA Cloud, the Core or the Output Player, and the version when the page names one.
> Only give settings, values and steps that are in these docs. Never invent one. If the docs don't cover it, say so.
> When the docs don't answer the question, send the user to Visual Radio Assist support at https://cloud.visualradioassist.live/support.

# Troubleshoot the Visual Designer

> Fix common Visual Designer problems: a visual that won't save, live data that stays empty, animations you can't edit, and failed imports or generations.

Each section starts from what you see in the [Visual Designer](https://docs.visualradioassist.live/visual-designer.md) or on air. When the app shows a message, the heading is that message.

## Visual cannot be saved in this state, check required fields.

The Visual Designer saves a visual only with a name of at least 2 characters and at least one layer. Add a layer and give the visual a name, then save again.

When **Save** shows **Locked for edit**, the visual is locked. See [Lock resources](https://docs.visualradioassist.live/lock-resources.md).

## A saved visual doesn't change on air

The Visual Designer updates every output that shows the visual right away when you save. When it doesn't change:

* **The visual is not saved.** Check **Saved** in the header, then save.
* **The output shows another visual.** Check which visual the rundown or scene plays.

## Live data in a visual stays empty

A text layer with live data shows nothing, or its fallback, when the data has no value.

* **Nothing is on air for that field.** A track field is empty between tracks, a program field when no program is scheduled. Add a fallback with **Fallback content**.
* **The data is not connected.** Track data needs [radio automation data](https://docs.visualradioassist.live/radio-automation-data.md), program data needs [Scheduling](https://docs.visualradioassist.live/scheduling.md).
* **The field no longer exists.** A chip shows **Variable Not Found** when its variable was deleted. Insert the field again with **Insert data**.

In the Visual Designer, **No live data for 2 fields** means the same. Click **Use preview data** to design with example values.

## A layer doesn't follow a brand color or text style change

The layer is no longer linked.

* **A color picked by hand** unlinks the layer from its brand color. Click the brand color swatch again, see [Brand colors](https://docs.visualradioassist.live/visual-designer/brand-colors.md).
* **A text layer set to Custom** does not follow a text style. Pick the style under **Style** again, see [Text styles](https://docs.visualradioassist.live/visual-designer/text-styles.md).
* **A style marked Overridden** is restyled by the station's custom CSS. Change or remove that CSS.

## Fix the JavaScript to edit animations

The JS of the visual has an error on the line in the message. The timeline keeps the last animations visible, but you can't edit them until the line is fixed. Open the **Code editor** and fix that line. The visual can still be saved.

## An animation can't be changed on the timeline

* **The animation has a Code only badge.** The code uses something the timeline can't change safely. Use **Edit in code**.
* **The visual shows Old animations.** Convert them first with **Convert animations**, see [Animations](https://docs.visualradioassist.live/visual-designer/animations.md#convert-old-animations).
* **The layer is a Bodymovin layer.** Its markers set the animation. You can only move its start on the timeline, see [Bodymovin / Lottie animation layer](https://docs.visualradioassist.live/visual-designer/bodymovin-lottie-animation-layer.md).

## The output removes this visual before the animation ends

The **Length** of the Out is shorter than its animations, so the output takes the visual off before they finish. Drag the length marker on the timeline, or click the end time in the timeline toolbar and set a longer **Length**.

## A font looks wrong in a visual

* **The font is not active.** Turn on **Active** for the font at **Settings → Outputs → Fonts**.
* **The weight is missing.** Upload the file for that weight, see [Use your custom font](https://docs.visualradioassist.live/getting-started/use-your-custom-font.md).
* **A Photoshop import or Bodymovin file uses a font the station doesn't have.** Upload it, or pick another font in the layer.

## Import failed

The website import of your branding stopped. The message under it says why:

* **We couldn't reach that website. Check the URL and try again.**
* **The import is taking longer than expected. Try again.**
* **The AI service is rate limited right now. Wait a minute and try again.**
* **The AI service is unavailable right now. Try again in a few minutes.**
* **The AI service is out of credit, so importing is paused.** Contact support, or fill in your branding by hand.
* **The AI service rejected our credentials.** Contact support, or fill in your branding by hand.
* **We couldn't extract branding from that website.** Try again, or fill in your branding by hand.

A failed [Photoshop import](https://docs.visualradioassist.live/visual-designer/import-from-photoshop.md) shows **Import failed** too. Try again, or try the file with fewer effects and masks.

## You've used all of this station's AI credits for this month. Contact support to continue.

The station used its AI credits for the month, so the generator is paused until the credits renew. Contact support for more credits. Importing branding from your website still works. It costs no credits.

## Daily AI generation limit reached for this station. Try again tomorrow.

A station generates at most 10 graphics per day, failed ones included. Try again the next day.

## Still not working

Contact support with the station, the name of the visual, the time of the problem and any message word for word.

## Related

* [Visual Designer](https://docs.visualradioassist.live/visual-designer.md)
* [Animations](https://docs.visualradioassist.live/visual-designer/animations.md)
* [Insert live data](https://docs.visualradioassist.live/visual-designer/insert-data.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.