# Forms

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Newsletter</strong></td><td><a href="/files/LGSLwC5LYU2XVjbfLKIa">/files/LGSLwC5LYU2XVjbfLKIa</a></td><td><a href="/pages/LUT3BGa79hAMoIGOWxpU#newsletter">/pages/LUT3BGa79hAMoIGOWxpU#newsletter</a></td></tr><tr><td align="center"><strong>Contact form</strong></td><td><a href="/files/d5RJqyHwNu8L0SfTE4Lk">/files/d5RJqyHwNu8L0SfTE4Lk</a></td><td><a href="/pages/LUT3BGa79hAMoIGOWxpU#contact-form">/pages/LUT3BGa79hAMoIGOWxpU#contact-form</a></td></tr></tbody></table>

<details>

<summary>Newsletter</summary>

<figure><img src="/files/ofq7WG0R4wNoQHdX0YYy" alt=""><figcaption><p>An example of a Group block that contain a Heading and a Newsletter</p></figcaption></figure>

The **Newsletter** block allows you to easily add a subscription form to your store, enabling users to sign up for updates, promotions, or newsletters.&#x20;

{% hint style="success" %}
Newsletter submissions are stored on the **Customers** page of your Shopify admin.&#x20;
{% endhint %}

#### ⚙️ **Block settings**

<table><thead><tr><th width="275">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Text alignment</strong></td><td>Choose the alignment of the text within the block.</td></tr><tr><td><strong>Newsletter term</strong></td><td>Add a rich text term or agreement that appears under the subscription form.</td></tr><tr><td><strong>Width</strong></td><td>Set the width of the newsletter block.</td></tr><tr><td><strong>Custom width</strong></td><td>Set a custom width (in %) if you selected the <strong>Custom</strong> option for <strong>Width</strong>.</td></tr></tbody></table>

{% hint style="info" %}
You can change the form placeholder text and success messages in the **Edit default theme content > Blocks > Email signup**.

![](/files/g81qcj9Z86mC5ygQPeZi)

![](/files/EUIS0CzhaXrSmfRRsZgL)
{% endhint %}

</details>

<details>

<summary>Contact form</summary>

<figure><img src="/files/ISnxsiRVjfO4b2F1vpEA" alt=""><figcaption></figcaption></figure>

The **Contact form** block enables you to add a functional contact form to your site, allowing users to submit inquiries directly.&#x20;

{% hint style="success" %}
Contact form submissions from are sent to your **store's sender email address**. You can find or change this sender email in your Shopify admin by going to **Settings** > **Notifications**.&#x20;

If you want to collect and manage contact form submissions more extensively, consider using the [Shopify Forms app](https://apps.shopify.com/shopify-forms), which allows you to view submissions in your admin and set up email notifications for each submission.
{% endhint %}

#### ⚙️ **Block settings**

<table><thead><tr><th width="275">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Width</strong></td><td>Choose the width of the form. </td></tr><tr><td><strong>Horizontal gap (Column gap)</strong></td><td>Adjust the gap between form fields horizontally.</td></tr><tr><td><strong>Vertical gap (Row gap)</strong></td><td>Adjust the gap between form fields vertically.</td></tr></tbody></table>

{% hint style="info" %}
Change the required fields' label and success/error message in the **Edit default theme content > Blocks > Contact form**.

![](/files/KJ7siP9oZoVInomebaMr)
{% endhint %}

#### Custom field block

The **Custom field** block is a private block that allows you to add custom fields to the Contact form.&#x20;

{% hint style="success" %}
Under the **Contact form**, click to add a nested **Custom field** block to it.
{% endhint %}

<figure><img src="/files/9XfX52Iind56Ek5oEOiX" alt=""><figcaption></figcaption></figure>

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.foxecom.com/pebble-theme/theme-blocks/forms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.