> For the complete documentation index, see [llms.txt](https://help.pagefly.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pagefly.io/page-structure-and-elements/editor/extra-functions/flymate-pageflys-ai-assistant.md).

# FlyMate - PageFly's AI Assistant

### Overview <a href="#kz8qqtqzbz1e" id="kz8qqtqzbz1e"></a>

{% hint style="warning" %}
**Important Note**: Feature is currently in beta testing phase. Only available to early-bird users and new users during initial rollout period
{% endhint %}

FlyMate is PageFly's AI-powered assistant designed to simplify, guide, and optimize every step of the page-building journey inside PageFly. This beta feature combines intelligent navigation, real-time guidance, smart content creation, and design modification to help merchants build better pages faster, easier, and with more confidence.

**Prerequisites:**

* Active PageFly account
* Access to PageFly Editor or Dashboard
* No additional setup required - FlyMate is ready to use immediately

### Feature Introduction <a href="#sslzw5hlvai9" id="sslzw5hlvai9"></a>

FlyMate serves as your AI co-pilot within PageFly, helping you navigate, learn, create, style, and optimize your PageFly store pages with real-time assistance, intelligent recommendations, and effortless design support. The AI assistant operates through natural language prompts and automatically detects your intent to provide the most relevant assistance.

Everything FlyMate builds follows your store's [Brand kit](https://help.pagefly.io/page-structure-and-elements/editor/extra-functions/flymate-pageflys-ai-assistant/brand-kit.md): your colors, fonts, buttons and corners, logo and voice.

### Core Capabilities <a href="#id-89s98a9icwxg" id="id-89s98a9icwxg"></a>

FlyMate operates through **4 core Intent groups**, each representing specific capability areas:

### Content Creation Intent <a href="#z2of6ssx141" id="z2of6ssx141"></a>

* **Create New**: Generate complete pages, sections, or individual elements based on business goals or campaign descriptions
* **Template to Section**: Insert ready-made sections from PageFly's template library based on user prompts and requirements

### UI Modification Intent (Editor only, requires element/section selection) <a href="#v5hwau81t31l" id="v5hwau81t31l"></a>

* **Element-level modifications**: Style, content, and behavior changes for individual UI elements
* **Section-level modifications**: Layout and styling adjustments for entire sections
* **Real-time preview**: Changes are applied immediately with visual feedback

### Navigation Intent <a href="#id-99l94gg3glja" id="id-99l94gg3glja"></a>

* **Internal Editor Navigation**: Switch between tabs and panels (Elements, Settings, SEO, etc.)
* **External Editor Navigation**: Return to Dashboard, Page List, Templates
* **External Navigation**: Provides manual guidance for actions outside the current interface

### Learning & Support Intent <a href="#q5n9ye7e38l1" id="q5n9ye7e38l1"></a>

* **Contextual Help**: Step-by-step guidance based on current context
* **FAQ Access**: Instant answers to frequently asked questions
* **Error Guidance**: Troubleshooting suggestions for common issues
* **Tutorial Requests**: Detailed walkthroughs for specific features

### Example Use Cases or Prompts <a href="#fureux8y3rjx" id="fureux8y3rjx"></a>

#### Content Creation: <a href="#ag7afm4lhrpw" id="ag7afm4lhrpw"></a>

* "Create a hero section for a summer sale campaign"
* "Add a testimonial section for fashion products"
* "Generate a countdown timer for product launch"

#### UI Modification: <a href="#vn84so8h7y9y" id="vn84so8h7y9y"></a>

* "Make this section background black"
* "Increase padding in the hero section"
* "Center this product image"

#### Navigation: <a href="#id-7k8bxze0kqjx" id="id-7k8bxze0kqjx"></a>

* "Open Page Settings"
* "Switch to SEO Optimization panel"
* "Go to Theme Style"

#### Learning & Support: <a href="#blsn28l6dwma" id="blsn28l6dwma"></a>

* "How do I create a sticky header?"
* "Why is my button not aligned properly?"
* "How can I set up mobile responsiveness?"

### Step-by-step Instructions <a href="#tltpvl3km24m" id="tltpvl3km24m"></a>

### Accessing FlyMate <a href="#dyqyibfgm43p" id="dyqyibfgm43p"></a>

#### In PageFly Editor: <a href="#id-1thzpcl7a52s" id="id-1thzpcl7a52s"></a>

1. **Open FlyMate**: click **Flymate** in the top toolbar of the Editor. The FlyMate panel opens on the right side
2. **Interface**: the chat is ready as soon as the panel is open
3. **Close it**: click **Flymate** in the toolbar again, or **×** in the panel, to hide the panel

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2FA6bZqjiOVDkM6qhOwJhf%2Fflymate-editor-panel.webp?alt=media" alt="The PageFly Editor with the FlyMate panel open on the right: What should change here?"><figcaption></figcaption></figure>

#### In PageFly Home and other screens: <a href="#rz3msp1thg2g" id="rz3msp1thg2g"></a>

1. Click **FlyMate** at the top of the page
2. The FlyMate panel opens on the right side of the screen
3. On Home, you can also type in the **Ask FlyMate to build, fix or check a page** box in the middle of the page
4. The panel provides full functionality for content creation, navigation help, and support

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2FcDjn0ySvcsR7RE88FLsi%2Fflymate-home-with-panel.webp?alt=media" alt="PageFly Home with the FlyMate panel open on the right"><figcaption></figcaption></figure>

#### Additional Access Notes: <a href="#tlu6o96cwz7z" id="tlu6o96cwz7z"></a>

* FlyMate maintains consistent availability across all PageFly interfaces
* The sidebar position and functionality remain the same whether in Editor or Dashboard
* On a phone, the FlyMate panel opens full screen
* No additional setup or configuration required - FlyMate is ready to use immediately upon access

### Getting Started with the FlyMate Panel

#### The welcome screen

When you open a new chat, FlyMate suggests where to start. Click a row to begin, or type your own request.

**On Home**, FlyMate asks **"What are we working on?"** and offers four choices:

* **Build a page**: from an idea, a link or a screenshot
* **Work on a page**: sections, edits, brand, analytics
* **A/B test results**: what is running and what is winning
* **How do I…**: answers from the help center

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2FPzfSgi5JtnHeNgzErGOl%2Fflymate-panel-welcome.webp?alt=media" alt="The FlyMate welcome screen on Home: What are we working on?" width="360"><figcaption></figcaption></figure>

**On a page in the Editor**, FlyMate asks **"What should change here?"** and shows the page name and its status. It offers:

* **Build a section**: on brand, from a short description
* **Edit an element**: select it, then say what to change
* **How is this page doing?**: traffic, conversion and revenue
* **Find issues**: Page Checkup scans the live page
* **Also:** Match my brand, Optimize images, Find a template

#### The panel header

* **Title**: click it to see your past conversations inside the panel
* **+**: start a new chat
* **Expand**: make the panel larger
* **⋯ menu**: open your [Brand kit](https://help.pagefly.io/page-structure-and-elements/editor/extra-functions/flymate-pageflys-ai-assistant/brand-kit.md), connect an AI assistant, or learn more
* **×**: close the panel

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2FySim7OCmbtaipMJniPKd%2Fflymate-panel-menu.webp?alt=media" alt="The FlyMate header menu: Brand kit, Connect an AI assistant, Learn more" width="360"><figcaption></figcaption></figure>

#### Before you send: what FlyMate will do

When you pause typing for a moment, FlyMate shows a line under the message box saying what **Send** will do, for example build a page, and about how many credits it will use.

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2FQzd6uoZ1FBvRsAqF6VQQ%2Fflymate-chat-before-send.webp?alt=media" alt="Under the message box, FlyMate shows what Send will do and about how many credits it will use" width="360"><figcaption></figcaption></figure>

{% hint style="info" %}
Working this out is free. Credits are only used after you click Send.
{% endhint %}

#### After each answer

Under each answer you can:

* **Like** or **Dislike** the answer to tell us how it went
* **Copy** the answer
* See about how many **credits** the answer used
* Click one of up to **three suggested next steps** to send it as your next message

#### When FlyMate needs a choice

* **Questions**: FlyMate asks in the chat and shows options to pick from. You can also type your own answer in the message box
* **Plans**: before a bigger build, FlyMate shows a plan. Click **Build it** to start, **Adjust** to change it, or **Cancel** to stop
* **While building**: FlyMate shows the steps (done, in progress, still to do) and a progress bar. Click **Stop** at any time

### Using FlyMate for Content Creation <a href="#id-1cggtv3iggbs" id="id-1cggtv3iggbs"></a>

#### Creating New Content: <a href="#r2pyvsxa8qji" id="r2pyvsxa8qji"></a>

1. In the FlyMate chat interface, type your content request
2. FlyMate will generate the requested content
3. Review the generated section/element
4. Added content to your page
5. Continue building or make additional requests

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2FgLAcAC10bV76TCSZ1Hoa%2Fflymate-editor-build-section.webp?alt=media" alt="FlyMate built a new section on the page in the Editor"><figcaption></figcaption></figure>

{% hint style="info" %}
You can send a link or a picture to show the style you want. FlyMate uses it for that build only and never changes your [Brand kit](https://help.pagefly.io/page-structure-and-elements/editor/extra-functions/flymate-pageflys-ai-assistant/brand-kit.md).
{% endhint %}

#### Suggest Template Page: <a href="#id-83gkfeyi2ux1" id="id-83gkfeyi2ux1"></a>

1. Describe the type of Page Template you need
2. FlyMate will suggest relevant page template from PageFly's template library
3. Select your preferred option
4. The template is automatically inserted into your page

### Using FlyMate for UI Modifications <a href="#ec00dy5ngqcb" id="ec00dy5ngqcb"></a>

**Note:** UI Modification requires you to be in the Editor with an element or section selected.

#### Modifying Elements: <a href="#id-3cyj3shamrzh" id="id-3cyj3shamrzh"></a>

1. **Select** the element you want to modify in the Editor
2. Type your modification request to FlyMate
   * Example: "Make this button dark green"
3. For some changes, FlyMate first shows **Review the proposed changes**. Click **Apply it** to make the change, **Adjust** to change your request, or **Cancel** to stop
4. Review the change on the page in real time
5. Continue with additional changes if needed

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2F6BnUK29W0yWQIcTbXKsb%2Fflymate-editor-review-card.webp?alt=media" alt="Review the proposed changes, with Cancel, Adjust and Apply it" width="360"><figcaption></figcaption></figure>

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2FIcZ0sSyZG09yeZFZBHca%2Fflymate-editor-edit-element.webp?alt=media" alt="FlyMate changed the selected button in the Editor"><figcaption></figcaption></figure>

#### Modifying Sections: <a href="#uhkvla1b802" id="uhkvla1b802"></a>

1. **Select** the entire section you want to modify
2. Describe your desired changes
   * Example: "Make this section full-width with centered content"
3. Changes are applied automatically
4. Verify the layout adjustments

### Using FlyMate for Navigation <a href="#id-1vzbtyfqywje" id="id-1vzbtyfqywje"></a>

#### Internal PageFly Navigation: <a href="#hwysn8xbc7z1" id="hwysn8xbc7z1"></a>

1. Request navigation to specific location
   * Example: "Open Analytics"
2. FlyMate will either:
   * Provide a button to complete the navigation

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2F4wZm2hPmcdIatRljbXrA%2Fflymate-chat-nav.webp?alt=media" alt="FlyMate answers Open Analytics with a button that opens Analytics" width="360"><figcaption></figcaption></figure>

#### External PageFly Navigation: <a href="#pixqqqqthprx" id="pixqqqqthprx"></a>

Flymate currently doesn't support users navigating outside of the PageFly App.

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2FnitvvRJIYD5a0TJtMmQy%2Fflymate-chat-ext.webp?alt=media" alt="FlyMate explains it can&#x27;t open Shopify admin screens and suggests next steps" width="360"><figcaption></figcaption></figure>

### Getting Help and Support <a href="#id-5mogtbcbsnxl" id="id-5mogtbcbsnxl"></a>

#### Contextual Assistance: <a href="#yqhjcgz41hlx" id="yqhjcgz41hlx"></a>

1. Ask questions related to your current task
   * Example: "How do I make this section responsive?"
2. FlyMate provides relevant, context-aware guidance
3. Follow the provided instructions

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2F666JnRCkBo7QulKtKUWQ%2Fflymate-chat-help.webp?alt=media" alt="FlyMate gives step-by-step tips for mobile and a card to open Sections" width="360"><figcaption></figcaption></figure>

#### Troubleshooting: <a href="#ks36ofwk7rg6" id="ks36ofwk7rg6"></a>

1. Describe the issue you're experiencing
   * Example: "My images are not displaying correctly"
2. FlyMate analyzes the problem and provides solutions

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2FpE4n756sYIuUoFDtWysB%2Fflymate-chat-trouble.webp?alt=media" alt="FlyMate asks about the image problem and offers options to pick from" width="360"><figcaption></figcaption></figure>

### Monitoring and Analytics <a href="#id-3d6vj3ryh3t4" id="id-3d6vj3ryh3t4"></a>

#### Conversation History <a href="#id-4nrpyjod3k56" id="id-4nrpyjod3k56"></a>

* Click the title in the FlyMate header to see your past conversations inside the panel
* Search by a word from the title or the chat
* Conversations are grouped by Today, Yesterday, Previous 7 days and Older, newest first
* Click a conversation to continue it
* To delete a conversation, open its actions and choose Delete. FlyMate asks you to confirm, because a deleted conversation can't be restored

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2FivbGNh9PuT6NiM1bcAYg%2Fflymate-chat-history.webp?alt=media" alt="Past conversations in the FlyMate panel, with search" width="360"><figcaption></figcaption></figure>

#### Session Management <a href="#z1ubu2pxx1on" id="z1ubu2pxx1on"></a>

* Each conversation keeps its context, so you can pick it up again later from your past conversations
* Click **+** in the header to start a new chat with a fresh context
* Conversation data is not shared between different PageFly accounts

### Additional Notes and FAQs <a href="#w6udiry0r54q" id="w6udiry0r54q"></a>

### Language Support <a href="#dux32ksmbqbr" id="dux32ksmbqbr"></a>

* FlyMate supports multiple languages including English and Vietnamese
* Language detection is automatic based on your prompt
* Responses will match the language of your input

### Error Handling <a href="#o4mxwbk3vps1" id="o4mxwbk3vps1"></a>

**When FlyMate encounters unclear or unsupported requests:**

#### Off-topic Requests: <a href="#bglh4fsak1xt" id="bglh4fsak1xt"></a>

* FlyMate will politely redirect to PageFly-related tasks
* Example response: "I'm designed to help with PageFly page building. Could you rephrase your request related to creating or editing pages?"

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2FM3OnojFXMDebgG9RLpnR%2Fflymate-chat-offtopic.webp?alt=media" alt="FlyMate declines a weather question and brings the chat back to PageFly" width="360"><figcaption></figcaption></figure>

#### Unsupported Actions: <a href="#id-1i6xbb8xx0ql" id="id-1i6xbb8xx0ql"></a>

* Clear explanation of current limitations
* Alternative suggestions provided
* Example: "I can't directly integrate with external services, but I can help you create a contact form section."

**Ambiguous Prompts:**

* FlyMate will ask clarifying questions
* Multiple options may be presented for selection, and you can also type your own answer
* Example: "I can help with buttons. Are you looking to add a new button, style an existing one, or change button text?"

<figure><img src="https://2800568630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLf471SpmnojuhVGQb2E%2Fuploads%2FsiPih86lj5fyowhp8jqL%2Fflymate-chat-ambiguous.webp?alt=media" alt="FlyMate asks what to do with buttons and shows options to pick from" width="360"><figcaption></figcaption></figure>

### Network and Technical Issues <a href="#nvsmo7k9h03a" id="nvsmo7k9h03a"></a>

#### Offline/Connection Issues: <a href="#somfh5gjxsnu" id="somfh5gjxsnu"></a>

* If a reply fails, for example because the connection dropped, FlyMate shows a warning in the chat
* Click **Try again** to send your last message again
* The warning also tells you whether any credits were used and whether anything on your page changed

#### Out of Credits

* If you have used this month's credits, FlyMate shows a card in the chat with **Get more credits**, **See plans** and **Connect an assistant**
* The message you typed is kept, so you can send it once you have credits
* With **Connect an assistant**, you can keep building from Claude or ChatGPT without credits

#### UI Modification Requirements: <a href="#ba3oj9dio4j0" id="ba3oj9dio4j0"></a>

* Error message: "Please select a section or element first to make modifications."
* Guidance provided on how to select elements properly

**Best Practices**

* Use specific, descriptive prompts for better results
* Select elements clearly before requesting UI modifications
* Set up your [Brand kit](https://help.pagefly.io/page-structure-and-elements/editor/extra-functions/flymate-pageflys-ai-assistant/brand-kit.md) so generated content matches your brand
* Test functionality across different devices after making changes

### Frequently Asked Questions <a href="#u9nepyukggjm" id="u9nepyukggjm"></a>

**Q: Can FlyMate work without internet connection?**

A: No, FlyMate requires an active internet connection to function as it processes requests through AI servers.

**Q: Does FlyMate save my conversation history between sessions?**

A: Yes. Click the title in the FlyMate header to see your past conversations, search them, and continue any of them.

**Q: Can I use FlyMate for multiple pages simultaneously?**

A: FlyMate maintains context when switching between pages within the same session, allowing seamless work across multiple pages.

**Q: What happens if FlyMate doesn't understand my request?**

A: FlyMate will ask for clarification or suggest alternative ways to phrase your request. It may also provide related options that might match your intent.

**Q: How do I know how many credits a request will use?**

A: As you type, FlyMate shows what Send will do and its credit range. Working this out is free. After each answer, FlyMate shows about how many credits it used.

**Q: Can FlyMate modify content in published pages?**

A: FlyMate works within the PageFly Editor environment. To modify published pages, you'll need to edit them in the PageFly Editor first.

**Q: How do I toggle FlyMate on/off?**

A: In the Editor, click **Flymate** in the top toolbar. On Home and the other PageFly screens, click **FlyMate** at the top of the page, and click **×** in the panel to close it.

**Q: Is FlyMate available on all PageFly interfaces?**

A: Yes, FlyMate is available throughout PageFly, including the Editor and Dashboard, with consistent functionality across all interfaces.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.pagefly.io/page-structure-and-elements/editor/extra-functions/flymate-pageflys-ai-assistant.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
