Troubleshooting Unknown Variable Errors in Webflow with Relume Components

Chef M. · 2025-06-12 12:06:42.948783+00

Hi there, I've been loving the preset relume components for my Webflow website! However, I keep getting an error message saying "Error: Unknown Variable" in my color parameters (fonts, strokes, background) whenever I load them into my pages. Any ideas on how to prevent this or fix this? I've created a style guide page but still get these error messages.

Troubleshooting Unknown Variable Errors in Webflow with Relume Components | Relume Community

11 comments

· Sorted by Oldest

Matt J.
·
Chef M. Would you mind sending a read-only link?
Chef M.
·
sure thing, thanks for the prompt response!
Chef M.
·
https://preview.webflow.com/preview/chef-mario?utm_medium=preview_link&utm_source=desi[…]o&preview=ff648bfc5629b238c21216a5379d2601&workflow=preview
Matt J.
·
Chef M. so it appears you are trying to retrofit Relume into an existing Webflow project. In that case, you'll want to follow this doc closely. https://www.relume.io/resources/docs/updating-existing-projects
Chef M.
·
Thanks Matt, I'll take a look. I did create a page for the relume style guide but perhaps I did so incorrectly
Matt J.
·
well, biggest thing is that you'll want to clone a copy of our webflow style guide project, and paste in the full proper page from that project into your current project. But the biggest issue is that because your project was not started using our webflow style guide, the variables were not in the project, and adding them after the fact doesn't work because of limitations with Webflow
Chef M.
·
Does this mean I have to start over?
Matt J.
·
Chef M. naw, in the doc I sent, there's a path forward for you to continue using Relume components in your project, you will just have to hook up the variables in your Webflow project manually to the components you import. You also won't be able to use our Relume Site Builder Import Webflow app to automatically import multiple pages into your Webflow project. But pasting in individual components from the component library will work fine if you follow the instructions in the doc provided.
Matt J.
·
However, my official official recommendation would be to start over. I would at the very least, test it out and see how much better/faster things come together and I think you might be surprised how quickly you would be able to recreate your existing site.
Matt J.
·
especially if you use Relume Site Builder and import directly into Webflow using our app.
Chef M.
·
You've been beyond helpful and informative. Thanks so much!