> For the complete documentation index, see [llms.txt](https://learn.withessential.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.withessential.com/administration/settings/let-customers-request-service-from-the-customer-portal.md).

# Let customers request service from the Customer Portal

Create and publish a service request form to give signed-in portal customers a **Request service** button. The portal fills the customer account and sign-in email automatically, so the form only needs to ask for details your team does not already know.

Build the form with the same section-and-field editor as the website intake form. The portal form has its own versions and does not change the public website form. You can add Preferred Availability and custom questions such as a short description, service category, or requested date. Customer Name, Contact Info, and Property Address are not available as form fields because the portal supplies that context separately.

![A Customer Portal service request with the signed-in customer, email, and property already filled](/files/g3V9SA44XnIo7VRyDjsr)

Select **Save** to publish the form. Once published, a portal customer can choose an existing property they are allowed to access. Contacts with customer-level portal access can also select **Request service at a new property** and enter an address; the address uses your business's State, Province, or Region options and the matching ZIP or postal-code wording. Contacts whose access is limited to particular properties can request service only for those properties. Required questions must be completed before the request can be sent.

![A Customer Portal service request for a new property with its address filled](/files/NWVB3ro1mx1y7Jpucw6i)

Every submission creates a task in **Tasks -> Service Requests -> All**. A prominent **Submitted through the Customer Portal** status pill and the signed-in email identify its source. Because the signed-in customer and selected existing property are authoritative, they do not carry matching-status tags; their links open the Essential customer and property records in a new tab. For a new address, select **Create New Property** at the bottom of **Request details** to open the full property form with the customer and submitted address prefilled. Complete any other required details or custom fields, then save to create the property and attach it to the request.

![A Customer Portal request task with prominent source context and links to its known customer and property](/files/9EK9jbW78QOjHXncS2dy)

The **Request service** action appears only after the form has been saved and published.

> **Where to find it:** Settings -> Customer Portal -> Service request form

## Related guides

* [What your customers see in the Customer Portal](/administration/what-your-customers-see-in-the-customer-portal.md)
* [What creates Service Requests tasks](/field-operations/tasks/what-creates-website-requests-tasks.md)
* [Build your intake form](/administration/settings/build-your-intake-form.md)
* [Enable or disable the Customer Portal for all customers](/administration/settings/enable-or-disable-the-customer-portal-for-all-customers.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://learn.withessential.com/administration/settings/let-customers-request-service-from-the-customer-portal.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.