• BLOCK SETUP GUIDES • SETUP GUIDE

How to configure Custom button on Thank you and Order status 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 button 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. Eligible Thank you and Order status app blocks are supported on Shopify Basic and higher. 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

  • Link customers to a care guide, shipping policy, or support page.
  • Copy a useful reference or short piece of text to the clipboard.

Configuration settings

Setting How to configure it
Label Describe the action, for example Read care instructions.
Action Choose a URL action or a copy-to-clipboard action.
Destination or content Use a complete URL for navigation; enter the exact text for copying.
Appearance Review the button style and alignment controls supplied by the form.

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 button 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: Open your shipping policy after an order

Example setup: A public shipping-policy URL on your own store.

Step-by-step instructions

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

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

  3. Choose the URL action offered by Custom button.

  4. Enter Read shipping policy as the label and the complete destination URL.

  5. Review the supported style and alignment controls.

  6. For a separate copy-to-clipboard demo, choose that action and enter the exact copyable content; do not assume URL and clipboard actions are the same.

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

  8. 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.

  9. 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
Read shipping policy selected The merchant policy opens.
Clipboard demo selected Paste into a test text field and verify the intended content was copied.
Phone view The label remains clear and the action is usable.

Important: 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. 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 button block on the selected supported page, followed by the final customer view.

Limitations

  • Opening a link does not confirm an external task was completed.
  • A clipboard action copies text; it does not apply a discount or submit an order.

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.