set_form_permission_inheritance

Make one form take its permissions from another, or stop it doing so. Use get_form_permissions_by_group first to see what each form currently has, because of what follows.

This is not a way to copy permissions once. A form that inherits keeps no permissions of its own: whatever it had is replaced by a copy of the other form’s, and it is replaced again every time the other form’s permissions change. set_form_permissions will refuse to work on it while the arrangement is in place.

The replacement is immediate and cannot be undone. There is no record kept of what the inheriting form had before, and clearing the arrangement later does not bring it back - the form simply keeps the permissions it inherited and becomes editable again. This tool reports what each affected form held beforehand so you have a record; if you might want those permissions back, save them somewhere before calling it.

Use it where several forms genuinely belong to one another and should always be reachable by the same people - the forms behind a single application, say - so that granting a group access once covers all of them. Do not use it to give a form the same permissions as another form as a starting point, because the copy is permanent and continues.

Visibility conditions are not copied. They reference elements, and the elements differ between forms, so an inheriting form keeps its own conditions and needs them set up separately.

Inheritance is one level deep. A form that inherits cannot also be inherited from, so chains are refused.