• BLOCK SETUP GUIDES • SETUP GUIDE

How to configure Custom field on supported order and account pages

By Rivio Support Team
4 min read

What you will achieve in this guide

Follow the feature-specific setup and testing instructions below. Check the supported pages and plan requirements before activating the feature.

EXPECTED SETUP TIME Varies by feature
COMPATIBILITY See requirements in this guide
TECHNICAL DIFFICULTY Zero Code Required

Use Custom field on its supported pages to help customers with the task described below. Configure it in Rivio, save its activation state, and then add the corresponding block in Shopify’s checkout and accounts editor.

Supported pages and requirements

Supported pages: Thank you, Order status, Profile. Eligible Thank you and Order status app blocks are supported on Shopify Basic and higher. Profile placement uses supported current customer accounts. Your Rivio app plan must also include the feature. Check the page labels on the current block card before setup.

When to use this block

  • Collect information specific to an order on a supported order page.
  • Collect a customer preference on Profile using the supported profile-field workflow.

Configuration settings

Setting How to configure it
Field label Explain the information the customer should enter.
Input type and options Choose the input control offered by the configuration screen.
Internal key Use a descriptive key if the form requests one, such as gift_message.
Storage context Check whether the configured field saves order-level or customer-level information.

Use the controls available in your current configuration screen. Save a clearly named configuration, then confirm that Shopify’s editor uses that same configuration.

Screenshot to add: The Custom field configuration form with its content and appearance settings visible.

Rivio blocks add content or input fields to supported checkout and account pages. Configure the content in Rivio and place the block in Shopify’s editor.

Worked example: Collect an order-specific gift message

Example setup: A text field labelled Gift message with helper text Maximum 120 characters, if you enforce that supported limit.

Step-by-step instructions

  1. Open UI extension blocks and find Custom field. Check the supported pages on its card.

  2. Choose Set up or Manage and create a configuration with a clear internal name.

  3. Add a supported text input and enter Gift message as its customer-facing label.

  4. Use a clear internal key where the form requires one, such as gift_message, and helper text explaining the intended content.

  5. Review the preview and any display conditions. For the first demo, leave optional conditions empty so you can isolate placement.

  6. Save as Active. Open the Checkout and Accounts Editor, select the intended configuration and supported target page, and add the matching Rivio block in a supported location.

  7. Select the saved configuration if prompted and save Shopify’s editor. Test the actual customer page on desktop and a phone.

Verify the result

Test case Expected result or verification
Submitted Happy birthday, Maya! Complete the order and check the saved order attributes for that value.
New order without a message Confirm the optional-field behavior.
VAT number input It collects text; it does not validate VAT status or change taxes.

Important: Order fields belong to that purchase. Use Custom profile fields for information that should persist on the customer account. Checkout-step UI blocks require Shopify Plus. For another surface, use only the pages supported by this block’s card.

If the result is different

Check What it means / what to do
Configured but not visible Confirm the matching block is placed and saved on the exact supported Shopify page/configuration.
Only some buyers see it Compare Active status and condition inputs, including customer login and surface data.
Configuration is not applied Check the saved configuration selected by the editor block and verify the correct page.

Add and verify each supported placement

  1. Open Settings → Checkout in Shopify admin and customise the intended configuration.
  2. Select the exact supported page: Thank you, Order status, Profile. For Profile, use the customer-account page selector.
  3. Add the matching Rivio app block in a supported location and select the saved configuration if prompted.
  4. Save the editor. Add and save each other intended page separately; one placement does not establish every placement.
  5. Preview desktop and mobile, then test the actual checkout, completed order, or signed-in account appropriate to that page.

Screenshot to add: Shopify’s editor showing the Custom field block on the selected supported page, followed by the final customer view.

Limitations

  • Collecting a VAT or tax identifier does not verify it or change tax treatment.
  • Order and Profile storage are different; verify the destination for the chosen surface.
  • A post-order field cannot prevent completion of an order that has already been placed.

Display conditions depend on the page. Customer tags require logged-in customer context. Selected shipping method is unavailable on Order status. On Profile, only Customer, Language, Market, and Time on page conditions are evaluated; cart and order conditions are ignored.

Need help?

Email support@rivioapps.com with your store domain, feature name, target page, the relevant settings, and a screenshot of the actual result. Include the test cart, customer, or order details needed to reproduce the issue.