Setting Up Link Groups in Konfiwear
Link groups connect multiple garment positions so they share a single customer input. When a customer types "10" into a jersey number field, that number appears on both the front and back of the garment simultaneously.
Before You Begin
Make sure you have:
An active Konfiwear account with admin or owner access
At least two positions configured in Assets → Positions (e.g., "Front Number", "Back Number")
At least one product that will use the link group
⚠️ Important: Each position can belong to only one link group. This is enforced at the database level. If a position is already assigned to a group, it must be removed before it can be added to a different one.
What Is a Link Group?
A link group ties multiple positions together with one input. The customer sees a single field — for example, "Number" — and whatever they enter appears at every position in the group. This is how jersey numbers, player names, and sponsor text work across the front and back (or sleeves) of a garment.
Each link group has:
Property | Description |
Name | Internal display name (e.g., "Jersey Number", "Player Name") |
Slug | Unique identifier within your account |
Input Label | The label shown to customers in the customizer (e.g., "Number", "Name") |
Input Type |
|
Max Length | Character limit — e.g., 2 for jersey numbers, 20 for names |
Required | Whether the customer must fill in this field |
Sort Order | Display ordering in the customizer |
Setup Instructions
1. Navigate to Link Groups
Go to Graphics → Link Groups from the sidebar tab navigation.
The Link Groups page shows a data table with columns for name, input label, input type, position count, product assignments, and actions.
Caption: The Link Groups table with groups listed alongside their member positions and product assignments.
2. Click Add Link Group
Click the Add Link Group button to open the creation dialog.
3. Fill in the group details
Field | Description | Required |
Name | Internal name (e.g., "Jersey Number Group") | Yes |
Slug | Auto-generated unique identifier. Editable. | Yes |
Input Label | The label customers see (e.g., "Number", "Player Name") | Yes |
Input Type |
| Yes |
Max Length | Maximum characters allowed. Set to | No |
Required | Whether the field must be filled to submit a quote | No |
Sort Order | Display sequence in the customizer | No |
Caption: The link group creation form with input configuration fields.
4. Add position members
Within the creation or edit dialog, add positions to the group:
Select a position from the dropdown (sourced from your Positions library)
Optionally configure per-member overrides:
Override | Description |
Font Size Override | Custom font size for this specific position (overrides the group default) |
Color Override | Custom text color (hex) for this position |
Alignment Override |
|
Transform Override | Advanced Fabric.js transform overrides (JSONB) |
Click Add to include the position in the group
Repeat for each position
Example — Jersey Number link group:
Position | Font Size | Color | Alignment |
Front Number | 48 | — (default) | center |
Back Number | 96 | — (default) | center |
The front number is smaller than the back number, but both display the same input value.
💡 Tip: Per-member overrides let you render the same content differently at each position. A jersey number might be 48px on the front but 96px on the back — the customer enters it once, but it renders at the appropriate size for each location.
5. Assign to products
In the assignment section, select which products and/or categories this link group applies to. Use the multi-select pill buttons.
Link groups assigned to a category apply to all products in that category.
6. Save the link group
Click Create. The group appears in the table.
Caption: A "Jersey Number" link group with Front Number (48px) and Back Number (96px) as members.
✅ Done! Your link group is configured. Customers will see the input field in the customizer when using the assigned products.
How Link Groups Work in the Customizer
The customer opens the customizer with a product assigned to the link group
The customizer shows the input field with the input label (e.g., "Number")
The customer types their value (e.g., "10")
The text renders simultaneously at every member position on the canvas
Each position uses its own overrides (font size, color, alignment)
The 3D model updates in real time via the canvas-to-texture bridge
Verify It Works
Open the customizer with a product assigned to this link group
Find the link group input field in the customizer panel
Type a test value and verify:
The text appears at every member position
Font sizes, colors, and alignments match the per-member overrides
The 3D model reflects the text correctly
Tips & Best Practices
Use number input type for jersey numbers — this validates digit-only input and avoids customers entering letters where only numbers are expected
Set max length to 2 for numbers — jersey numbers rarely exceed two digits
Set max length to 20–25 for names — covers most player names without allowing excessively long strings
Make jersey numbers required — most production workflows need a number on every jersey
Use per-member font size overrides — the back number is typically 2× the front number size
Name groups by function, not position — "Jersey Number" is clearer than "Front + Back Number Group"