> For the complete documentation index, see [llms.txt](https://docs.powerfulform.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powerfulform.com/display-and-placement/app-block.md).

# App block

Place a form into any page or template using the theme editor's app block. Best when your theme is customized and you need precise control over where the form appears.

## 💡 Compare this method with others

| Situation                                                             | Recommended Method                     |
| --------------------------------------------------------------------- | -------------------------------------- |
| Theme or page template is customized, or you need precise positioning | **App Block** (this method)            |
| Simple pages or you want the fastest setup                            | Shortcode embed / default form display |
| Need to show form in product description or content area              | Shortcode inside product/page content  |

## 📝 How to set it up

{% stepper %}
{% step %}

### Copy the Form Shortcode

1\. Open the app > click **Forms** > open a form you want

2\. Click **Publish** button on the right corner

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2Fgit-blob-abb36d5236c6708c7542896c0b28af6f68c1538a%2Fscreenshot-imported-display-and-placement-add-a-form-with-app-block-1.png?alt=media" alt=""><figcaption></figcaption></figure>

3\. Select the display of the form: default, boxed, floating, popup

4\. Click **Get short code** > copy the short code of the form

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2Fgit-blob-1f33b029981c9595d9ca82d56f16fa9c9c327074%2Fscreenshot-imported-display-and-placement-add-a-form-with-app-block-2.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Add the Form as an App Block

1\. From the Shopify admin page, click **Sale channels** > **Online store** > click **Edit theme** to go to the theme you want

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2Fgit-blob-3a81dcdb5f1f81e24a939b7ed48a521f79740a7d%2Fscreenshot-imported-display-and-placement-add-a-form-with-app-block-3.png?alt=media" alt=""><figcaption></figcaption></figure>

2\. In theme editor > open the page template you want

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2Fgit-blob-16c28d914e2f56eac4f5e5896a80281e7ec693e4%2Fscreenshot-imported-display-and-placement-add-a-form-with-app-block-4.png?alt=media" alt=""><figcaption></figcaption></figure>

3\. Click **Add section** > add **Form** app section

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2Fgit-blob-9d77e146e879181554c2f1e06cacbdaa35707ea7%2Fscreenshot-imported-display-and-placement-add-a-form-with-app-block-5.png?alt=media" alt=""><figcaption></figcaption></figure>

4\. In the app section > paste the form **shortcode** here

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2Fgit-blob-7e3563f706caddcaf957f561e65f1c1004c88e63%2Fscreenshot-imported-display-and-placement-add-a-form-with-app-block-6.png?alt=media" alt=""><figcaption></figcaption></figure>

5. Optionally, drag-and-drop or reorder blocks to control where the form appears on the page
6. Click **Save** to apply changes.
   {% endstep %}

{% step %}

### Preview and Check the Live Store

After saving, open the live version of the page (front store) to verify that the form appears correctly in the intended position.
{% endstep %}
{% endstepper %}

## 🎥 Tutorial video

{% embed url="<https://www.youtube.com/watch?v=cnzv24qtQGw>" %}

## 🔧 Troubleshooting

If your form does not appear, check the items below:

<details>

<summary>1. Make sure the form is **published</summary>

Forms must be saved and published in the app before they will show on your store.

</details>

<details>

<summary>2. Ensure the page is using the **correct template</summary>

If you added the form inside a specific theme template (e.g., a custom product template), make sure that product or page is actually using that template.

</details>

<details>

<summary>3. Some themes require minor adjustments</summary>

Certain Shopify themes may require:

* Block placement adjustments
* Template changes
* Section settings updates

If you’re unsure, we’re here to help.

</details>

<br>

## Next steps

* [Get embed code of a form](/display-and-placement/short-code.md) — the code the block needs.
* [Theme integration](/display-and-placement/enable-the-app-embed.md) — the store-wide switch. The app block carries its own code, so a form placed in a block keeps working with the embed off; see [Forms loading on every page](/troubleshooting/forms-load-everywhere.md).
* [The form is not showing on my store](/troubleshooting/form-not-showing.md) — checks to run if nothing appears.