Skip to main content
A variant can ask the buyer questions before they pay: a username to add them by, a region to set them up in, a note. The buyer answers at checkout, under the product they are buying, and the answers are on the order with everything else.

​
Setting them up

On a product’s Variants tab, press Edit on the variant, open Delivery, and switch Custom Fields on. The first question opens straight away. Press Back to Fields to see the list, where Add Field adds another and a row’s menu deletes one. Drag a row to change the order the buyer is asked in. The questions are saved with the product, by Save Changes. Switching Custom Fields off stops the buyer being asked, and keeps the questions for when you switch it on again. A variant can ask up to 10 questions.

​
Where the buyer answers

  • On the checkout, on a page of their own titled For Your Order, before the payment, on a phone as on a computer. Continue to Payment takes the buyer to the payment page, where their answers are one row under their email, with Edit to go back to them. With several products asking, each product’s name is over its own.
  • In an embed, the same way: once the buyer has picked an option, the questions on their own with Continue to Payment, then the payment, with the answers on one line and Edit.
  • In the Checkout Kit, the same way again: the questions on their own in the payment piece with Continue to Payment in the pay piece, then the payment methods with the answers on one line.
Nothing goes on until every required question is answered: the buyer is taken to the first one that is not. A question that may be left says “(optional)” beside it. A product that asks nothing has no questions page, and its checkout is one page as before. Your labels, hints and options are shown as you wrote them, in whatever language the buyer reads the checkout in. A buyer is asked once for each variant in their order, however many of it they buy. Questions are asked wherever a buyer checks out. They are not asked on an invoice or a payment link you send, or on an order you mark as paid yourself.

​
Where the answers are

  • On the order’s page, in a Custom Fields card under what was delivered, each answer under its question, with a copy button beside the short ones.
  • In the orders file from Export CSV, in a Custom Fields column: every answer of the order, or the line’s own when each row is a product line.
  • In the API, as customFields on the order: a group for each variant, each answer with its key, its label and its type. The same order is in your webhooks.
  • In the request to your own server for dynamic delivery, as customFields, the line’s answers by key: {"discord_username": "ada"}.
An answer is kept with its question as it read when the buyer answered, so changing or deleting a question later does not change orders already placed. A tick box that was ticked reads “Yes”.

​
From your own server

A variant’s questions are its customFields, and its switch is customFieldsOn, in Create a product and Update a product. Either left out of an update stays as it is.