> For the complete documentation index, see [llms.txt](https://help.byinspiredlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.byinspiredlabs.com/product-page/product-information/line-item-property.md).
# Line item property
The **Line item property block** is a highly customizable feature in the Product information section that allows store owners to collect additional information from customers during the shopping process. It is particularly useful for stores offering personalized or customizable products (e.g., engraving, gift notes, or custom sizes). Each field created in the **Line item property block** is tied directly to the product being added to the cart, ensuring the additional details are captured and included in the order.
### Settings:
1. **Field type:**
{% tabs %}
{% tab title="Text - short" %}
Creates a single-line input field for short text entries. Best for collecting concise information such as names, dates, or short phrases.
{% endtab %}
{% tab title="Text - long" %}
Creates a multi-line input field for longer text entries. Ideal for detailed information, such as instructions or lengthy customization details.
{% endtab %}
{% tab title="Dropdown" %}
Creates a dropdown menu for customers to select one option from predefined values. Useful for product options like sizes, materials, or predefined customization choices.
{% endtab %}
{% tab title="Checkbox" %}
Displays a checkbox that customers can tick to indicate agreement or preference. Often used for agreements, gift-wrapping options, or optional add-ons.
{% endtab %}
{% tab title="Radio buttons" %}
Functions like a dropdown, but displays all options at once using radio buttons. Perfect for presenting a visible list of exclusive choices, such as color or design preferences.
{% endtab %}
{% endtabs %}
2. **Label:** Adds a descriptive heading above the field to clarify its purpose. Example: "Add your personalization" or "Select your preferred color."
3. **Placeholder:** Sets placeholder text inside the input field, providing customers with an example of what to enter. Applies to **Text - short** and **Text - long** fields. *Example*: "Enter your message here."
4. **Required:** Marks the field as mandatory. If unchecked, the product can be added to the cart without filling in the field. If checked, customers must complete the field; otherwise, they cannot proceed to the cart.
5. **Dropdown** field settings**:**
* **Options:** Enter all the dropdown choices separated by commas (e.g., "Small, Medium, Large"). Each value will appear as a selectable option in the dropdown.
6. **Checkbox** field settings**:**
* **Checked value:** Specifies the value that will be recorded when the checkbox is selected. Example: "Gift wrap included."
* **Unchecked value:** Specifies the value that will be recorded when the checkbox is not selected. Example: "No gift wrap."
7. **Radio buttons field settings:**
* **Options:** Enter all the choices separated by commas (e.g., "Option 1, Option 2, Option 3"). Each choice will appear as a visible option with a corresponding radio button.
* **Layout:** Determines whether the radio buttons are displayed in a single row (**horizontal**) or stacked (**vertical**).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.byinspiredlabs.com/product-page/product-information/line-item-property.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.