Registry /
storage / react-hook-form-persist
Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
useFormPersist
✓ import { useFormPersist } from 'react-hook-form-persist'
✗ const useFormPersist = require('react-hook-form-persist')
ESM-only; named export. CommonJS require will fail in v3.
default import
✓ import useFormPersist from 'react-hook-form-persist'
✗ const { useFormPersist } = require('react-hook-form-persist')
Hooks are exported as default and named. Default also works.
useFormPersist (react-hook-form 6)
✓ import { useFormPersist } from 'react-hook-form-persist'
✗ import useFormPersist from 'react-hook-form-persist/v2'
Same import path for v6, but watch 'name' vs 'watch' difference in options.
Demonstrates persisting react-hook-form state to localStorage with a storage key.
import React from 'react';
import { useForm } from 'react-hook-form';
import { useFormPersist } from 'react-hook-form-persist';
function App() {
const { register, handleSubmit, watch, setValue } = useForm();
useFormPersist('form-key', { watch, setValue });
const onSubmit = (data) => console.log(data);
return (
<form onSubmit={handleSubmit(onSubmit)}>
<input {...register('firstName')} />
<input type="submit" />
</form>
);
}
Errors
Common errors & fixes
TypeError: Cannot read properties of undefined (reading 'subscribe')
Missing 'watch' function in config object
fixPass { watch: watch } from useForm() to useFormPersist() options. Error: useFormPersist requires react-hook-form 6 or higher
Using an incompatible version of react-hook-form
fixEnsure react-hook-form is version 6+.
Warning: useFormPersist: Storage key already in use
Duplicate keys across multiple forms
fixUse a unique key for each useFormPersist call.
Failed to parse stored form state: SyntaxError: Unexpected token u in JSON
Corrupted or invalid JSON in storage
fixClear the stored value in localStorage or handle gracefully.
Audit
Dependencies
react-hook-formrequiredPeer dependency required to hook into form state