Documentation

Form blocks: contact, newsletter, map and order tracking

The Story Theme Contact form (and its 15 field types), Newsletter, Map and Order tracking blocks, with their settings.

Form blocks let your customers write to you, sign up for your newsletter, find your store or track their package. They're in the Forms and contact category of the block picker and can be added to any section: a Contact page, the footer, a popup, a tracking page.

The Narvo demo contact form on a gray background: name, email, phone, order number, message, consent checkbox and Send button
The Narvo demo contact form on a gray background: name, email, phone, order number, message, consent checkbox and Send button
Screenshot to take — Theme editor > a page > Contact section > Add block: picker open on the "Forms and contact" category (Contact form, Newsletter, Map, Order tracking)

At the end of their panel, all these blocks have Show on (Desktop and mobile, Desktop only, Mobile only), the Sizing group and the Animations group. They aren't repeated below.

Contact form

The Contact form block sends the customer's message to your store's email address (the one in Settings > General in Shopify). Each field is a sub-block: you choose which ones to show, in what order, and which are required. By default, it contains Full name, Email, Phone, Order number and Message.

  • Labels: Inside the fields (the label acts as placeholder text, like on Narvo) or Above the fields. Spacing between fields (16 px).
  • Consent > Display: None, Required checkbox (the message won't send unless the box is checked) or Information text. The Text can be customized; leave it empty to keep the default text, translated into the visitor's language.
  • Button: Button text, Button style, Width (Fit content or Full width) and Confirmation message shown after sending.
  • Appearance: Background (None, or a Color palette with its Inner spacing) and Corners.
The Sylys Contact page: contact information and opening hours on the left, form on a beige background on the right
The Sylys Contact page: contact information and opening hours on the left, form on a beige background on the right

The form fields

Every field has a Label (it also names the answer in the email you receive), an optional Help text under the field, and most have a Placeholder and a Required checkbox.

FieldWhat it's forSpecific settings
Full nameThe name in a single fieldRequired by default
First name / Last nameThe name in two fieldsRequired by default
EmailThe address to reply toAlways required
PhoneTo call the customer back—
CompanyFor a B2B store—
Order numberFind the orderPlaceholder #1001
SubjectThe topic of the messageChoices: one per line for a list, empty for free text
MessageThe free textHeight (lines): 5 by default; required by default
Short textA free answer on one line—
Dropdown listOne choice from a listChoices: one per line
Single choiceRadio buttonsChoices: one per line
CheckboxA yes/no option ("Call me back")—
DateA date (appointment, event)—
NumberA quantityMinimum and Maximum

Even if you remove the Email sub-block, Shopify requires an address: the field stays.

Newsletter

The Newsletter block signs your visitors up to your emails. Subscribers land in Shopify Customers, as marketing subscribers, with the tag of your choice.

The Ma Petite Ruche Newsletter block: Email field with the "Sign me up" button next to it, under a heading and a text, beside a photo of beehives
The Ma Petite Ruche Newsletter block: Email field with the "Sign me up" button next to it, under a heading and a text, beside a photo of beehives
  • Button: Arrow inside the field (default, understated, ideal in a footer), Next to the field or Below the field. Button text and Button style for the last two.
  • Field label and Ask for the first name.
  • Customer tags: newsletter by default. Add one tag per source (footer, welcome-popup) to know where your subscribers come from.
  • Collect phone numbers for SMS: adds an optional phone field. The SMS consent checkbox becomes required as soon as a number is entered, and the Tag for SMS consent (sms-consent) is added to the customer.
  • Marketing consent: None, Information text or Required checkbox.
  • Confirmation message shown after signing up.
  • Discount code to reveal: the code appears with a Copy button right after signing up.
The "Newsletter with discount" variant: a "Welcome offer" badge, a heading promising 10% off, then the field and the Subscribe button
The "Newsletter with discount" variant: a "Welcome offer" badge, a heading promising 10% off, then the field and the Subscribe button

Map

The Map block shows a Google Maps map of your store, with a directions link.

The "Store locations" variant: three store cards with the illustrated map, the "Show map" and "Directions" buttons, the address and opening hours
The "Store locations" variant: three store cards with the illustrated map, the "Show map" and "Directions" buttons, the address and opening hours
  • Place Name and Address (empty = your store's address). Show the address on the map, Zoom (15 by default).
  • Load the map automatically: unchecked by default. The map then only loads when the visitor clicks Show map: the page stays fast and nothing is sent to Google before that.
  • Directions link and its Button style.
  • Cover image: shown until the map loads. Without an image, an illustrated map in your theme colors is shown. Grayscale until hovered.
  • Height (460 px) and Height on mobile (320 px), Corners, pin Color.

Order tracking

The Order tracking block lets customers track their package with their tracking number, without writing to you. Results come from the 17TRACK service, loaded only when the customer runs a search.

The Sylys Order tracking block: two tabs, "Track a package" and "Find my order", the Tracking number field and the "Track my package" button
The Sylys Order tracking block: two tabs, "Track a package" and "Find my order", the Tracking number field and the "Track my package" button
  • Field label, Help text, Button text and its Button style.
  • Button: Next to the field or Below the field.
  • Let customers choose the carrier and Carriers to list (for example USPS, UPS, FedEx; empty = all).
  • Remember recent searches on the customer's device.
  • Display: Show a Find my order tab with its text, and List the recent orders of logged-in customers.
  • Appearance: background (None, Color palette, Color), border, corners, Inner spacing, Shadow.
The same block on the Narvo demo, more understated: gray tabs and a black "Track" button attached to the field
The same block on the Narvo demo, more understated: gray tabs and a black "Track" button attached to the field

Close button

The Close button can only be added to a Popup. It's the "No thanks" under a sign-up form, or the "No, leave" button of an age verification.

The Sylys newsletter popup: photo, heading, Email field, Subscribe button, and the "No thanks" link below
The Sylys newsletter popup: photo, heading, Email field, Subscribe button, and the "No thanks" link below
  • Label: "No thanks" by default.
  • Style: Link (discreet, the default) or a button style.
  • Never show the popup again after this click: visitors who decline aren't asked again.
  • Full width and Alignment.

It's essential when the popup is set to Require a choice before browsing: the X and the Escape key are then disabled, so this button is the only way out. See Popups.

Learn more