Skip to content


title: CFE-ConfigValidator-2: Your config contains a value for the setting, but this is not a valid setting name

This error occurs when MPF does not know a setting you specified in a device.


For instance, a switch knows certain settings:

    number: 1
    label: My Left Flipper Switch Example
    tags: some_custom_tag

You can see which settings are allowed in the config reference of your device.

Common Pitfalls


The most common source for this kind of error are typos. Check the name of your referenced device with the setting. Casing matters here (i.e. upper/lower case). Using an IDE with the MPF language server can help here.

Mixing Devices

Maybe you accidentially copied config attributes from a different type of devices? Double check if you refered to the documentation of the correct device. If you find incorrect documentation please tell us in the forum.

Incorrect Indent

With nested configs (i.e. slide_player or widget_player) you might have used an option which should be indented one level further or one level less. This can sometimes be a bit tricky. Using an IDE with the MPF language server can help here.

Running Config from a different MPF Version

Sometimes MPF config specifications change. Check if your MPF version fits the config. If in doubt check the config reference for your device.

Need more help troubleshooting?

Have a look at our Troubleshooting section. It might give you some hints for certain classes of problems.

What if this did not fix your problem?

Please tell us about your error in the community forum and we might be able to update this page afterwards. Or even better: You help us to update it afterwards.

Is something missing here? Do you have a helpful hint for others experiencing this error?

Please create a Pull Request and add it. Alternatively, please tell us in the community forum.

Something missing or wrong? You can fix it!

This website is edited by people like you! Is something wrong or missing? Is something out of date, or can you explain it better?

Please help us! You can fix it yourself and be an official "open source" contributor!

It's easy! See our Beginner's guide to editing the docs.

Page navigation via the keyboard: < >

You can navigate this site via the keyboard. There are two modes:

General navigation, when search is not focused:

  • F , S , / : open search dialog
  • P , , : go to previous page
  • N , . : go to next page

While using the search function:

  • Down , Up : select next / previous result
  • Esc , Tab : close search
  • Enter : go to highlighted page in the results