# AI Writer

{% hint style="info" %}
**Who can use this feature?**

* This feature is available for all users
  {% endhint %}

AI Writer offers two ways to generate a full blog post:

| Mode                          | Best for                          | Access                                            |
| ----------------------------- | --------------------------------- | ------------------------------------------------- |
| [**Quick mode**](#full-mode)  | Fast drafts from a simple prompt  | Dashboard → "What would you like to write today?" |
| [**Full mode**](#full-mode-1) | Structured posts with SEO control | Content Manager → Create new post → AI Writer     |

### Quick mode <a href="#full-mode" id="full-mode"></a>

Generate a blog post instantly with just a text prompt.

1. **Write a prompt:** On the Dashboard, type what you want to write in the prompt box (e.g., "Write a helpful blog post about how to choose the right product for first-time buyers, in a friendly tone with clear headings and a short FAQ").
2. **Add context** *(optional):* Attach additional information to give the AI more to work with:
   * **PDF upload**: Upload a document (product guide, research, brand guidelines) and the AI will use its content as reference.
   * **Product data**: Select a product from your Shopify store — the AI pulls in product details (title, description, features) to write about.
3. **Generate:** Click the send button. The AI creates a full blog post based on your prompt and any attached context.
4. **Review and edit:** You are taken to the blog editor with the generated draft. Edit, add elements, and publish when ready.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FboTv0G25EMXQNqgmCsVo%2Fimage.png?alt=media&#x26;token=fe151d55-467a-49a7-b7cd-f5fbd777efe7" alt=""><figcaption></figcaption></figure>

#### Recommended blog posts <a href="#recommended-blog-posts" id="recommended-blog-posts"></a>

Below the prompt box, the Dashboard shows **Recommended blog posts** - AI-suggested topic ideas based on your store.&#x20;

Each suggestion includes a post title, search intent, main keyword, and short description. Click **Generate now** on any suggestion to instantly create that post.

### Full mode <a href="#full-mode" id="full-mode"></a>

A guided 3-step flow with full control over SEO keywords, outline structure, tone, and content type.

```
Step 1: Configure blog post → Step 2: Select outline → Step 3: Generate blog post
```

**Location in app:** Content Manager → Create new post with AI

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2F3vCs0Ol2Uaf5EmcaXwW1%2Fimage.png?alt=media&#x26;token=2939971b-32c1-4083-bc04-5debe7181ffc" alt=""><figcaption></figcaption></figure>

#### Step 1. Configure blog post <a href="#step-1-configure-blog-post" id="step-1-configure-blog-post"></a>

Set your content goals and preferences to guide the AI.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FMRgbFK5tHjT9tp3nItUk%2Fimage.png?alt=media&#x26;token=f607e55c-c390-4289-af83-6427e26dfa5b" alt=""><figcaption></figcaption></figure>

| Setting                              | Description                                                                                                                                  |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Topic**                            | What the blog post is about (e.g., "Tips to choose handmade soap")                                                                           |
| **Main SEO keyword**                 | The primary keyword to target (e.g., "Handmade soap")                                                                                        |
| **Secondary SEO keywords**           | Additional keywords to include (e.g., "Handmade soap for men")                                                                               |
| **Length & structure**               | Post length - Standard (1000-1500 words) or other options                                                                                    |
| **Language**                         | The language of the generated post                                                                                                           |
| **Post type**                        | Navigational, Informational, Tutorial, Commercial, or Transactional                                                                          |
| **Special instruction** *(optional)* | Custom directions for the AI (e.g., "Highlight unique product features, mention material and color, keep tone professional and descriptive") |
| **Writing tone** *(optional)*        | Writing style — Formal, Professional, Casual, Friendly, etc.                                                                                 |
| **Audience** *(optional)*            | Target readers (e.g., "General, women ages 25-30")                                                                                           |

Click **Continue** to proceed.

#### Step 2. Select outline <a href="#step-2-select-outline" id="step-2-select-outline"></a>

The AI generates a heading outline based on your settings.

1. **Review the outline** - Check the proposed H2/H3 heading structure.
2. **Edit headings** - Rename, reorder, add, or remove headings to match your vision.
3. **Generate images in content** *(optional)* — Check this option to auto-generate one image per H2 section.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2Fhna8qCk9A6lcuuNs4TXh%2Fimage.png?alt=media&#x26;token=5b4620c9-05a8-4ade-b806-952bac47d835" alt=""><figcaption></figcaption></figure>

Click **Continue** when the outline looks right.

#### Step 3. Generate blog post <a href="#step-3-generate-blog-post" id="step-3-generate-blog-post"></a>

The AI writes the full post based on your settings and outline.

1. **Wait for generation** - The AI creates the complete article. This may take 30-60 seconds depending on length.
2. **Review the post** - You are taken to the blog editor with the generated content.
3. **Edit and refine** - Adjust text, add elements, update images, and fine-tune before publishing.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FCEBBuLGJxVaEagB8Zt6Z%2Fimage.png?alt=media&#x26;token=e05d4335-581e-43d9-b00e-23b4d69f42fe" alt=""><figcaption></figcaption></figure>

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2F4QNFmZY2Tt7BNn5PLaBN%2Fimage.png?alt=media&#x26;token=0cd21be9-e252-469d-bcc7-a3497092de41" alt=""><figcaption></figcaption></figure>

### Tips for better results <a href="#tips-for-better-results" id="tips-for-better-results"></a>

* **Fill in secondary keywords** - This helps the AI naturally weave related terms into the content.
* **Use special instructions** - The more specific your directions, the more relevant the output. Mention brand voice, product details, or points to emphasize.
* **Customize the outline** - Don't skip Step 2. Rearranging or renaming headings gives you a post that matches your intended structure.
* **Enable image generation** - Saves time if you need section images, but review them afterward for relevance.
