# Creating Your First Page

This guide walks you through creating a Smart Page from scratch.

## Step 1: Open Smart Pages

In your Shopify admin, open the PageFly app. Click **Smart Pages** in the navigation to open the Smart Pages dashboard.

If this is your first time, you'll see an empty state with a **"Create your first page"** button.

## Step 2: Start page creation

Click the **"Create page"** button. A creation modal will open with the following options:

### Choose a page type

* **Product** — A dedicated page for a specific product or all products
* **Landing** — A marketing or campaign page
* **About** — Tell your brand story
* **Contact** — Contact information and forms

### Assign products or collections (optional)

For **Product** and **Collection** page types, you can choose **All products** or **Specific items** from your Shopify catalog.

### Write a prompt (optional)

Give AI custom instructions for your page. For example:

> "Create a product page for our premium coffee brand. Focus on the origin story, brewing instructions, and customer reviews. Use warm earth tones."

### Upload reference images (optional)

Drag and drop images for design inspiration — screenshots of pages you like, mood boards, or brand assets.

### Advanced options

* **Page title** — Set a custom title, or leave blank for AI to generate one
* **Goal** — Increase conversions, Boost AOV, Build trust, Showcase products, Drive email signups, Reduce bounce rate, or custom goal

## Step 3: Generate the page

Click **"Create page"**. AI creates a draft page and starts generating sections. Typical generation takes 30–60 seconds.

{% hint style="info" %}
You can cancel generation at any time by clicking the **Cancel** button in the top bar. Sections already generated will be kept.
{% endhint %}

## Step 4: Review and edit

Once complete, you can:

* **Chat with AI** to refine sections — [Editing with AI Chat](/smart-pages/editing-with-ai-chat.md)
* **Add more sections** — [Section Generator](/smart-pages/managing-sections/section-generator.md)
* **Edit elements directly** — [Inline Element Editing](/smart-pages/managing-sections/inline-element-editing.md)
* **Reorder sections** by dragging them in the section list
* **Preview on different devices** using the device toggle (mobile, tablet, desktop)

## Step 5: Publish

Click **Publish** in the top bar. See [Preview & Publish](/smart-pages/preview-and-publish.md) for details.

## Tips for better results

* **Be specific in your prompt** — Detailed instructions get better results
* **Set a goal** — Helps AI prioritize the right elements
* **Upload reference images** — Even a rough screenshot helps AI understand the style you want
* **Iterate with chat** — Your first generation is a starting point. Refine section by section


---

# 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://help.pagefly.io/smart-pages/creating-your-first-page.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.
