> For the complete documentation index, see [llms.txt](https://docs.avastudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avastudio.com/ingredients/troubleshoot-ingredients.md).

# Troubleshoot ingredients

Ingredient problems usually come from missing references, unclear names, overloaded text, or prompts that do not actually use the ingredient.

If an ingredient is not affecting a scene, check that the prompt references it with the correct `@` tag. A product image in the ingredient panel will not influence a scene unless the prompt or model input uses it.

If a text ingredient creates bad pacing, shorten it or split it into scene-specific ingredients. If an image ingredient creates inconsistent visuals, replace it with a cleaner reference and remove conflicting prompt descriptions.

If a template has broken ingredient references, restore the original ingredient names or update every prompt that depends on them.
