docs(plugin-form-builder): add warning about GraphQL type name collis… (#12720)

### What? Add a warning to the form builder plugin docs about potential GraphQL type name collisions with custom Blocks or Collections. ### Why? To help users avoid schema errors caused by conflicting type names and guide them with resolution options.

Author: gwesterman

docs/plugins/form-builder.mdx

@@ -470,6 +470,31 @@ formBuilderPlugin({
 })
 ```
 
+### Preventing generated schema naming conflicts
+
+Plugin fields can cause GraphQL type name collisions with your own blocks or collections. This results in errors like:
+
+```txt
+Error: Schema must contain uniquely named types but contains multiple types named "Country"
+```
+
+You can resolve this by overriding:
+
+- `graphQL.singularName` in your collection config (for GraphQL schema conflicts)
+- `interfaceName` in your block config
+- `interfaceName` in the plugin field config
+
+```ts
+// payload.config.ts
+formBuilderPlugin({
+ fields: {
+ country: {
+ interfaceName: 'CountryFormBlock', // overrides the generated type name to avoid a conflict
+ },
+ },
+})
+```
+
 ## Email
 
 This plugin relies on the [email configuration](../email/overview) defined in your Payload configuration. It will read from your config and attempt to send your emails using the credentials provided.
@@ -526,4 +551,4 @@ Below are some common troubleshooting tips. To help other developers, please con
 
 ![screenshot 5](https://github.com/payloadcms/plugin-form-builder/blob/main/images/screenshot-5.jpg?raw=true)
 
-![screenshot 6](https://github.com/payloadcms/plugin-form-builder/blob/main/images/screenshot-6.jpg?raw=true)
+![screenshot 6](https://github.com/payloadcms/plugin-form-builder/blob/main/images/screenshot-6.jpg?raw=true)