---
title: pos.home.modal.render
description: >-
  Renders a full-screen modal interface launched from smart grid tiles. The
  modal appears when users tap a companion tile. Use this target for complete
  workflow experiences that require more space and functionality than the tile
  interface provides, such as multi-step processes, detailed information
  displays, or complex user interactions.


  Extensions at this target support full navigation hierarchies with multiple
  screens, scroll views, and interactive components to handle sophisticated
  workflows.
api_version: 2025-07
api_name: pos-ui-extensions
source_url:
  html: >-
    https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets/smart-grid/pos-home-modal-render
  md: >-
    https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets/smart-grid/pos-home-modal-render.md
---

# pos.​home.​modal.​render

Renders a full-screen modal interface launched from smart grid tiles. The modal appears when users tap a companion tile. Use this target for complete workflow experiences that require more space and functionality than the tile interface provides, such as multi-step processes, detailed information displays, or complex user interactions.

Extensions at this target support full navigation hierarchies with multiple screens, scroll views, and interactive components to handle sophisticated workflows.

### Examples

* #### Create a full-screen modal from a tile

  ##### Description

  Build a full-screen modal interface launched from smart grid tiles. This example demonstrates creating a modal that appears when merchants tap a tile, supporting complete workflows with multiple screens, scroll views, and interactive components for sophisticated tasks.

  ##### React

  ```tsx
  import React from 'react'

  import { Text, Screen, ScrollView, Navigator, reactExtension } from '@shopify/ui-extensions-react/point-of-sale'

  const Modal = () => {
    return (
      <Navigator>
        <Screen name='HelloWorld' title='Hello World!'>
          <ScrollView>
            <Text>Welcome to the extension!</Text>
          </ScrollView>
        </Screen>
      </Navigator>
    )
  }

  export default reactExtension('pos.home.modal.render', () => <Modal />);
  ```

  ##### TS

  ```ts
  import {
    Navigator,
    Screen,
    ScrollView,
    Text,
    extension,
  } from '@shopify/ui-extensions/point-of-sale';

  export default extension('pos.home.modal.render', (root) => {
    const navigator = root.createComponent(Navigator);
    const screen = root.createComponent(Screen, {
      name: 'HelloWorld',
      title: 'Hello World!',
    });
    const scrollView = root.createComponent(ScrollView);
    const text = root.createComponent(Text);

    text.append('Welcome to the extension!');
    scrollView.append(text);
    screen.append(scrollView);
    navigator.append(screen);
    root.append(navigator);
  });
  ```