Guides

Configuration

Configuration

Reference for every option you can pass when creating an instance.

February 18, 2026

Written by Devon Aliu

Passing options

Options are passed as a plain object at initialization time. Every option is optional — omit anything you don't need to override and the default will be used instead.

Common options

Most projects only need to touch a handful of options: a target container, an initial state, and a handful of event callbacks. Everything else is there for teams with more specific requirements.

Updating configuration at runtime

Configuration isn't fixed at initialization — call the instance's update method with a partial options object at any time, and only the keys you pass will change.

  • Keep runtime updates small and targeted

  • Avoid replacing the entire options object on every render

  • Read Theming next if you're customizing appearance rather than behavior

Create a free website with Framer, the website builder loved by startups, designers and agencies.