Custom Options

Customization options are a new feature available in Honey 5.0.0 and later.

Shopify allows you to create up to three product variants, such as Size, Color, and Material for any given product. However, Honey 5.0.0 and later offers the possibility to add additional customization options using our Customization picker block. This feature is helpful when you want to offer customization options such as engraving or monogramming, custom image or file uploads, or even set a custom ship date.

Set-up Customization picker block

1. Select the Product Template you want to edit from the dropdown menu in the top bar, Products > [Product template name].
2. Under the Product information section click (+) Add block and select the Customization picker block.
3. If desired, change the order of your blocks by using the drag and drop handles ⋮⋮
4. Select Option type to choose the type of custom input to display. Honey offers nine custom input types:
   1. Buttons
   2. Checkboxes
   3. Color picker
   4. Date picker
   5. Dropdown

   6. File upload

      Accepted file types: JPG, JPEG, PNG, GIF, WebP, PSD, TIFF, BMP, SVG, MOV, MP4, MP3, WAV, CSV, PDF, DOC, DOCX, TXT, RTF, JSON, JS, CSS.

   7. Multi line text
   8. Single line text

   9. Swatches

      

      
      

      Note: If you select the 'File upload' option type, the dynamic 'Buy Now' buttons will be hidden automatically. This prevents any issues with the file upload process.

      You can locate uploaded files by navigating to your Shopify Admin > Orders > Select an Order > Custom file. Click the link to download the file.

      

5. Add an Option name. This identifies the custom option and must be unique. This option name is visible to the customer in the cart, cart drawer, and on the order in the Shopify Admin.

   Important: Option name MUST be unique for this feature to work.

6. Add an Option label. These are the instructions that the customer will see for the custom option on the product page. For example, if your option name is 'Engraving' your option label might be 'Add custom engraving?'
7. If you want to require customers to make a selection before they can add the item to their cart, enable the Make required option. This setting only applies to the following types: Checkbox, File Upload, Multi line text, and Single line text.
8. For Dropdowns, Swatches, Buttons, and Checkboxes, add your available options to the Customization options field. Enter the options you want to display separated by commas. For example, if you have swatches for 'Paper type', your options might be 'Lined, Plain, Dotted'.
9. If you have Swatches selected, you may select a Swatch shape if desired. Honey offers three options: Circle, Square, and Rectangle. This setting only applies if your option type is Swatches. You also must upload an image for each option to your Shopify files. Let's take the 'Lined' paper type option as an example.
   • Create a PNG image for each option.
   • We recommend a minimum size of 292 x 292px.
   • The name of the file must match this exact structure: 'product-option-[option-name]-[option]'.
     • If the option name or the option has a space such as 'Paper type' then the text must be hyphenated. In our example, the name of the file must be product-option-paper-type-lined.png .
   • On your Shopify Admin go to Content > Files
   • Click Upload files and add all option images that you created.
10. If desired, you can change the size of the swatches using the Swatch size slider.
11. For Checkboxes, if you want to force the customer to select a minimum number of options, use the Minimum number of selections required field to enter the minimum number you want to force the customer to select. If you don't want to enforce a minimum number of selections, leave this blank.
12. For Checkboxes, if you want to limit the customer to a maximum number of selections, use the Maximum number of selections allowed field to enter the maximum number you want to allow the customer to select. If you don't want to enforce a maximum number of selections, leave this blank.
13. For Multi line text and Single line text, you may Set max character length to set a limit of the number of characters allowed. If you don't want to enforce a maximum text length, leave this field blank.
14. For the Date picker, you may enforce a Minimum number of days from today that the customer is allowed to select. The earliest allowed day is calculated based on the current date in the customer's time zone plus the number of days you enter in this field. This is helpful if you don't want to allow a customer to select a date in the past. This setting is optional.
15. For the Date picker, you may enforce a Latest allowed date that does not allow a customer to select a date past a certain point in the future. This is helpful if you want a customer's birthdate. This setting is optional.
16. Click Save.

If you have custom products with required options, you must disable the Quickshop option for these products. If not, the customer will be able to add the item to her cart using the Quickshop button, bypassing your required selections. To do this, please follow the next steps:

1. On your Shopify Admin, go to Settings > Custom data > Products
2. Click Add definition in the top-right.
3. Add 'Customization picker' in the Name field. You must use this exact name for the feature to work.
4. In the Namespace and key field, replace the word 'custom' for 'theme.' The text should look exactly like this theme.customization_picker
5. Click (+) Select type.
6. Under the Other group select True or false.
7. Click Save.

8. On your Shopify Admin, go to Products and select the product that has required custom selections.
9. Scroll down to the Metafields section and click on Customization picker and select True.
10. Click Save.
11. Repeat steps 8 - 10 for every product that has required custom selections.