Grapevine Surveys is an app block compatible app, making it much easier for merchants to add post-purchase surveys to their order thank you and order status pages directly from Shopify's checkout editor.

With app block compatible post-purchase pages, merchants can make code-free customizations to their checkout post-purchase pages by including blocks created by the apps that they currently use. The goal is to enhance the buying journey by building more personalised post-checkout experiences for customers.

Once your store has been migrated to use app block compatible post-purchase pages, you can use the Shopify checkout editor to include your post-purchase survey into your thank you and order status pages.

Your post-purchase checkout pages will display the survey that has been made visible on the Order Status Page (OSP) channel within the Grapevine Surveys app:

The conditional options to display the survey to new, returning or all customers will also work with our app block.

If you have one survey published on the Order Status page (OSP) for new customers and a completely different survey published for returning customers, these conditions are compatible with our app block and the correct survey will be presented to the customer based on those conditions.

All of our question types are compatible with our app block.

Within the Shopify Admin, go to Settings > Checkout and you will see a card titled Checkout customization. Click on the Customize button to enter the checkout editor:

​Shopify checkout customization

The Grapevine Surveys app block can be added to both the Thank You page (the initial post-purchase page after checkout) and the Order Status page (the page used to display the order summary at any point after the initial purchase).

You will need to add the Grapevine Surveys app block for each post-purchase page separately, however, the steps you need to take are almost identical for each.

You will see the option to customize the Thank you page or Order status page by clicking on the dropdown in the top bar of the checkout editor:

Let's go ahead and customize the Thank you page first.

Within the checkout editor, click on the dropdown selector at the top of the page and select the Thank you page.

Once the page loads, take a look at the left-hand panel of the checkout editor, locate the Order details section and select the + Add app block link at the bottom of that section:

Grapevine Surveys will then appear as an available app block to be selected:

Click on the Survey Form app block and the checkout editor preview panel will update to show your post-purchase survey on your Thank you page:

Hit the Save button in the top right of the checkout editor.

Within the checkout editor, click on the dropdown selector at the top of the page and select the Order status page.

Once the page loads, take a look at the left-hand panel of the checkout editor, locate the Order status section and select the + Add app block link at the bottom of that section:

Click on the Survey Form app block and the checkout editor preview panel will update to show your post-purchase survey on your Order status page:

Hit the Save button in the top right of the checkout editor.

Your survey will start to appear on your app block compatible post-purchase pages.

Once you have added the Grapevine Surveys app block to your Order status page and/or the Thank you page, you should start receiving survey responses into the app.

Responses submitted via app block compatible post-purchase pages will show as coming from either of the following channels:

You will see these channels listed against your survey responses:

The graphs you see when viewing a survey will also be filterable by these channels.

You will also able to determine if customers are more likely to submit your survey on the Thank you page immediately after a purchase, or at a later date when revisiting their order details on the Order status page by looking at the Responses Over Time by Channel chart:

Are my surveys fully compatible with app blocks? For example, I have configured my survey to only be answered once per customer. Will those settings still be applied?

Surveys added to the Order status page and Thank you page using the checkout editor will observe the majority of settings and publishing options that have been configured for your survey, e.g. tagging; only capturing one response per customer; displaying the survey to new or returning customers etc.
​
The only settings that will not be carried across are any custom CSS styles that you may have previously specified for your legacy Order status page.

Whilst the styling of your post-purchase survey is not possible when delivered via an app block, you can customize the branding of your checkout pages in the checkout editor where you can add your brand's logo, add a background image, change the colors, and choose a new font to make the checkout page match your brand.

What channels should I make my surveys visible on for them to work with my app block compatible post-purchase pages?

You need to make sure that your survey is set to be visible on the Order status page (OSP) channel within the Grapevine Surveys app for it to appear on the Order status page and the Thank you page.

You can select this within the Manage visibility section of the checkout editor.

Will my Grapevine Surveys automatically appear on the Order status page and the Thank you page or do I have to add them manually using the checkout editor?

You will need to make sure that you have added the Grapevine Surveys app block to both the Order status page and the Thank you page using Shopify's checkout editor.

Will the Google Analytics integration still create GA events when a survey response is received?

Unfortunately, surveys delivered via the app block on your post-purchase pages does not currently support the creation of Google Analytics events when a survey is submitted from an Order status page or Thank you page. We will continue to look for a solution to this limitation.

We're currently investigating the potential to publish a specific survey on the Thank you page independently from the Order status page. We will update this article as soon as we have that capability.

If you have any questions about Grapevine Surveys and app block compatible post-purchase pages, then please do just get in touch.