> For the complete documentation index, see [llms.txt](https://docs.pakk.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pakk.io/websites/checkout/custom-checkout-questions.md).

# Custom Checkout Questions

Set up custom questions that customers need to answer in the last step of the checkout.  Use this feature to elicit extra information from your customers.

### Setting up Custom Questions

Custom questions are set at Website level.  Select the Website to edit then go to `General Settings > Checkout and Signup > Custom Checkout Questions`

### Title and Introduction

If required, you can provide a title and introduction to the custom questions - this will be displayed before the questions on your website.

### Custom Questions

<figure><img src="https://2553116242-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkTaBpmn8aX5KjLYTOO52%2Fuploads%2FPuZVF0nP4nKmc8KjEjJh%2FScreenshot%202024-10-30%20at%2010.13.25.png?alt=media&amp;token=db0f6251-7c60-42aa-8eb5-d013fc6f14ec" alt=""><figcaption><p>Example of a choice-type custom question</p></figcaption></figure>

For each question you want to add, you'll need to set the following:

* Question: this is the precise wording that will be presented to the customer
* Required: is an answer to this question required.  In the case of 'checkbox' question types, this means that the box MUST be ticked
* Type: what type of question is this?  Text allows free form input of any characters, whereas number and date will restrict the type of data that can be entered.  Choice type will present a list of pre-defined choices that you will have to set up.  Checkbox is simply a boolean yes/no checkbox.

### Checkout Display of Custom Questions

<figure><img src="https://2553116242-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkTaBpmn8aX5KjLYTOO52%2Fuploads%2F7g5gWNlj4kXNd0Zc0ymh%2FScreenshot%202024-10-30%20at%2010.14.30.png?alt=media&amp;token=013590b3-2ee4-4bc3-9219-e2f1f77b649b" alt=""><figcaption><p>Example of how custom questions are displayed on the checkout</p></figcaption></figure>

Custom questions are displayed in the last stage of the checkout, just before the customer clicks the main 'Place Order' button.

### Viewing Custom Question Answers

Answers to questions are logged against the order that was placed in the checkout.  There are numerous ways you can access and use these answers:

#### Order Detail View

<figure><img src="https://2553116242-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkTaBpmn8aX5KjLYTOO52%2Fuploads%2F4zyg2CzJPXkxro7AIZMj%2FScreenshot%202024-10-30%20at%2010.18.30.png?alt=media&amp;token=dc4d2e19-7c49-4bd7-bc19-cc83ecf7c320" alt=""><figcaption><p>Example of how answers to custom questions are shown on the Order detail page</p></figcaption></figure>

View on Order detail view:  click into an order to view it and go to the `Checkout` tab.  You'll see the answers to the custom questions under `Customer Checkout Details.`

#### Order List View

You can also add checkout answers to any Order list view by customising the view in the usual way.  Only the answers are shown (without the question), in order to conserve space.

Order Emails and PDFs

Answers to custom questions appear on Order confirmation emails and PDFs as well as picking and dispatch notes.

#### API/Webhooks

<figure><img src="https://2553116242-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkTaBpmn8aX5KjLYTOO52%2Fuploads%2FGfgubwOffHwgJ19LbeBz%2FScreenshot%202024-10-30%20at%2010.21.18.png?alt=media&amp;token=30481a40-588c-427f-a528-6afbbf1520f6" alt=""><figcaption><p>An example of custom responses in the API/Webhook data for an Order</p></figcaption></figure>

You'll find answers under `customFieldResponses` when accessing/sending Order data via the API or Webhooks.  **Note that the key for each response is the verbatim question text, so when accessing answers, you'll need to know the exact question text.**


---

# 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://docs.pakk.io/websites/checkout/custom-checkout-questions.md?ask=<question>&goal=<endgoal>
```

`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.