> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ilitylabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add a surface

> Add a website to your workspace and choose how Ility finds its pages.

A surface is one website that Ility tests. Add one surface for each site, and a separate one for each environment you want to track, such as staging.

## Add a site

**1. Open Surfaces**

In the sidebar, choose **Surfaces**, then **Add surface**.

**2. Enter the base URL**

Enter the address Ility should start from, such as `https://www.example.com`. Ility only crawls pages on this site.

If the base URL redirects to its `www` or apex variant, or from `http` to `https`, Ility crawls the site it lands on. You can enter either form.

**3. Name it (optional)**

Give the surface a name your team will recognize, such as "Marketing site". Ility shows the URL under the name. Leave it blank to show the URL alone.

**4. Choose a group (optional)**

Pick a group to file the surface under, for example the client it belongs to. You can change this later.

**5. Choose how Ility finds pages**

* **Discover from the URL above** (recommended) follows links from the base URL to find pages. It works on any site.
* **Use sitemap.xml** reads the site's sitemap from the standard path. It is faster and more complete when the site has one.

Choose **Add surface and start crawl**, or **Add surface and crawl sitemap** if you picked the sitemap.

Ility starts mapping the site straight away and scans the first page it finds, so you see findings before the crawl finishes. When the crawl is done, scan the remaining pages from the **Automated coverage** card on the surface's **Overview**. See [Run a scan](https://docs.ilitylabs.com/scans/run-a-scan.md).

> [!NOTE]
>
> Discovery crawling is included in paid plans and in your trial. Reading a sitemap is available on every plan.

## Manage pages

The **Crawled URLs** view of a surface lists every page Ility knows about. From there you can:

* **Exclude** a page so scans skip it, and include it again later.
* Mark a page as **priority**. Issues on priority pages rank higher. The homepage is a priority page by default.
* **Rescan** one page, or select several pages and rescan them together.
* **Recrawl** the site to refresh the page list, either by discovery or from the sitemap.

## Group surfaces

Groups keep related surfaces together in the **Surfaces** list, for example every site for one client. A group is only a label. It doesn't change settings, scans, or who can see what.

* To create, rename, or delete a group, use the **Groups** menu next to **Add surface**.
* To move a surface into or out of a group, open the menu on the surface's row and choose **Move to group**.

Deleting a group never deletes the surfaces in it. They become ungrouped.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.