Managing Positions in Konfiwear

---

Prerequisites

⚠️ Important: You need admin or owner access to your Konfiwear account.

---

What Is a Position?

A position is a named placement area on a garment. It tells the customizer: "here is where the customer can put something." Each position has three layers of configuration:

The Identity layer is what you configure today. Placement and Constraints will get a dedicated visual editor in a future update.

---

Navigating to Positions

Go to Assets → Positions from the sidebar. The Positions page shows a data table of all your positions with search, sorting, and pagination.

Each row displays the position name, slug, content type badge, and enabled status.

Caption: The Positions list page with content type badges (graphic, text, both) on each row.

---

Content Types

Each position has a content type that controls what customers can place there:

The content type is displayed as a colored badge on the position row.

💡 Tip: Use specific content types rather than "Both" wherever possible. Restricting a position to text for the jersey number zone or graphic for the logo zone keeps the customer experience focused and prevents production ambiguity.

---

Creating a Position

1. Click Add Position

On the Positions page, click the Add Position button. The creation dialog opens.

2. Fill in the position details

Caption: The position creation form with the content type selector.

3. Save the position

Click Create. The position appears in the list.

---

Editing and Deleting Positions

• Edit — Click a position row or use the Edit action. All fields are editable.

• Delete — Use the row's action menu. Deletion is permanent.

---

How Positions Connect to the Customizer

Positions work in conjunction with graphic zones and link groups (configured in the Graphics module) to define the full placement experience:

1. Positions define what can be placed (graphic, text, or both) and where on the garment

2. Graphic zones define the boundaries and constraints of each placement area on the canvas

3. Link groups connect multiple positions so they share the same input — for example, a jersey number that appears on both the front and back

When a customer opens the customizer, positions determine which placement slots are available. The customer selects a slot, then adds their content within the defined constraints.

---

Recommended Position Setup

Here's a standard position set for a soccer jersey:

💡 Tip: Use the jersey number positions as a link group — when the customer enters "10", it appears on both the front and back number positions simultaneously.

---

Result

After creating your positions, the Positions table shows all configured zones with their content type badges and enabled status. These positions become available in the customizer for graphic and text placement.

✅ Done! Your positions are configured. The customizer will show these placement zones to customers when they add graphics or text to a garment.

---

Tips & Best Practices

• Name positions by location and side — "Front Chest Center" is unambiguous, "Position 1" is not

• Use consistent slugs across products — if multiple products have a front chest zone, use the same slug (front-chest-center) so link groups and configurations are portable

• Start with the most common placements — chest, back, and sleeves cover the majority of customization needs

• Set content type precisely — a "Jersey Number" position should be text, not both

• Disable rather than delete — if a position is temporarily unavailable, disable it to preserve its configuration

---

Related Articles

• Understanding the Assets Module

• Managing Colors in Konfiwear

• Managing Sizes in Konfiwear