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

# Wix Integration

> Publish GEO-optimized content from Siftly directly to your Wix blog or Wix Headless CMS using the Wix Content Manager API.

<Frame>
  <img src="https://mintcdn.com/siftly/IwND2vAxRbhCiRev/images/cms-integrations.svg?fit=max&auto=format&n=IwND2vAxRbhCiRev&q=85&s=2704e9affce00587d23137bf707339c7" alt="Supported CMS platforms including Wix" className="rounded-xl" width="900" height="280" data-path="images/cms-integrations.svg" />
</Frame>

## Overview

This guide is for Wix users who want to publish Siftly-generated content and apply GEO/SEO recommendations. After following it, you'll know how to connect Siftly to Wix, where to find SEO fields in the Wix dashboard, and the limitations of Wix's platform for structured data.

**Difficulty:** ✅ Non-tech friendly — Wix has a visual SEO panel. ⚠️ JSON-LD requires a paid plan.

Wix is one of the world's most popular website builders, with millions of sites built on its platform. The Siftly–Wix integration uses the **Wix Content Manager API** (part of the Wix Headless platform) to create blog posts and CMS collection items directly from Siftly's content editor.

<Note>
  Wix uses **fixed API fields** — no schema mapping is needed. Fields are pre-configured to match Wix's Blog API structure. This is different from other CMS integrations that use the 3-tier field mapping system.
</Note>

***

## Prerequisites

Before connecting, you'll need:

* A Wix site with a **Blog** or a **CMS Collection** set up
* A **Wix API key** with the necessary permissions (see below)
* Your Wix **Site ID**

<Note>
  The Wix integration requires your site to be on a **Wix Premium** plan. The Content Manager API is not available on free Wix sites.
</Note>

***

## Step 1: Get your Wix API key

Wix uses API keys to authenticate third-party integrations.

1. Log in to [manage.wix.com](https://manage.wix.com)
2. Select your site
3. Go to **Settings → Advanced → API Keys**
4. Click **Generate API Key**
5. Give it a name (e.g., "Siftly")
6. Under **Permissions**, enable:
   * **Wix Blog** → Read & Write
   * **Wix Media** → Read & Write (required for hero image and content image uploads)
   * **Wix Content Manager** → Read & Write (if using CMS Collections)
7. Click **Generate** and copy the API key

### Get your Site ID

Your Site ID is in the URL when you're in the Wix dashboard:
`https://manage.wix.com/dashboard/{YOUR_SITE_ID}/...`

Copy the UUID string between `/dashboard/` and the next `/`.

***

## Step 2: Connect Wix in Siftly

1. In Siftly, go to **Settings → Integrations**
2. Click **Connect** next to **Wix**
3. Enter your:
   * API Key
   * Site ID
4. Click **Verify Connection**

Siftly will verify your credentials and detect whether your site has a Blog and/or CMS Collections.

***

## Step 3: Choose your publish target

Wix offers two content targets:

### Wix Blog

Publish content as a **blog post** on your Wix blog. This is the simplest option — Siftly maps directly to Wix Blog fields.

### Wix CMS Collection

Publish content to a custom **CMS Collection** (e.g., a "Resources" or "Case Studies" collection). You'll need to map Siftly's fields to your collection's fields.

Select your preferred target in **Settings → Integrations → Wix → Configure**.

***

## Field Mapping (Fixed Fields)

Wix uses a fixed API structure — fields are pre-configured and do not require manual schema mapping. Siftly maps content to Wix's built-in fields automatically.

### Pre-configured Fields

| Siftly Field         | Wix Blog Field              | Notes                                                        |
| -------------------- | --------------------------- | ------------------------------------------------------------ |
| **Title**            | Post title                  | Required — always sent                                       |
| **Slug**             | Custom URL slug             | Required — always sent                                       |
| **Body**             | Post content (Ricos format) | Required — HTML is converted to Wix's Ricos rich-text format |
| **Meta Description** | Excerpt                     | Auto-populated from content                                  |
| **Keywords**         | Hashtags                    | Auto-populated from content keywords                         |

<Note>
  Unlike other CMS integrations, Wix does not use the 3-tier field mapping system. The fields above are fixed by Wix's Blog API and cannot be remapped.
</Note>

***

## Custom Fields

You can define custom fields in Siftly for your Wix integration. These fields are stored locally and appear in the publish dialog for your reference, but they are **not sent to the Wix API** due to API limitations.

<Warning>
  Wix's Blog API does not support arbitrary custom fields on blog posts. Custom fields you define in Siftly are saved locally for tracking purposes only. To add custom data to your Wix posts, use Wix's CMS Collection approach instead or edit posts directly in the Wix dashboard after publishing.
</Warning>

### Field Types (local only)

| Type    | Description                  | Example                           |
| ------- | ---------------------------- | --------------------------------- |
| String  | Plain text                   | Author name, subtitle             |
| Number  | Numeric value                | Priority, reading time            |
| Boolean | True/false                   | Featured post, comments enabled   |
| JSON    | Structured object            | SEO config, social media metadata |
| Select  | Pick from predefined options | Category, status, content type    |

### Select Options with Separate Labels and Values

When adding a **Select** custom field, you define the available options in a textarea. Each option can have a separate **value** (sent to CMS) and **label** (shown in the dropdown):

```
value:label
```

**Example — Labels differ from values:**

```
1:Health
2:Tech
3:Food
4:Fashion
```

The dropdown shows `Health`, `Tech`, etc., but Siftly sends `1`, `2`, etc. to the CMS API.

**Example — Labels same as values:**

```
food
tech
health
fashion
```

When no `:` is present, the option text is used as both the label and value. This is backward-compatible with existing configurations.

***

## Publishing

### Draft vs Published

When publishing to Wix, content is always created as a **draft** in the Wix dashboard. You'll need to open the Wix blog editor to review and publish it to your live site.

<Note>
  Wix's Blog API creates posts as drafts regardless of the status you select in Siftly. This is a Wix API limitation. Open your Wix dashboard to publish the draft post.
</Note>

### Standard Fields at Publish Time

Standard fields (title, slug, body, excerpt, hashtags) are auto-populated from your content — no manual input needed.

***

## Rich text in Wix

Wix Blog accepts rich text via its own editor format (Ricos). Siftly converts generated content to Wix-compatible format, preserving:

* Headings (H1-H4)
* Bold and italic formatting
* Ordered and unordered lists
* Hyperlinks (including Siftly-generated internal links)
* Blockquotes

<Tip>
  After publishing, open the post in Wix's blog editor to add a **cover image** and review the formatting. Images are not auto-generated — you'll need to upload or select a featured image manually.
</Tip>

***

## SEO fields in Wix

Siftly populates Wix's built-in SEO fields when publishing:

* **Page title** — Mapped from Siftly's generated title
* **Meta description** — Mapped from Siftly's meta description
* **Slug** — Custom URL path

These are set in Wix's **SEO Settings** panel for the post. Verify them after publishing to ensure they look correct.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="API key rejected (401 error)">
    Regenerate the API key in Wix **Settings → API Keys** and update it in Siftly. Make sure the key has **Blog Write** and/or **CMS Write** permissions enabled.
  </Accordion>

  <Accordion title="Site ID not found">
    Copy the Site ID from the URL in Wix manage. It should be a UUID format like `a1b2c3d4-e5f6-...`. Do not use your site's display name or domain.
  </Accordion>

  <Accordion title="Post is created but body is empty">
    This can happen if Wix rejects unsupported HTML tags during Ricos conversion. Check the Siftly publish log for any warnings. Try removing custom formatting from the content draft and republishing.
  </Accordion>

  <Accordion title="CMS collection doesn't appear in the dropdown">
    Make sure your API key has **Wix Content Manager** write permissions enabled. Only collections with at least one text field will appear in Siftly's collection list.
  </Accordion>

  <Accordion title="Publish succeeds but post doesn't appear on the site">
    Siftly creates posts as drafts in Wix. Go to your Wix blog dashboard → **Posts → Drafts** and click **Publish** to make it live.
  </Accordion>
</AccordionGroup>

***

## Wix Headless (advanced)

If you're using **Wix Headless** to power a custom frontend (Next.js, Nuxt, etc.) with Wix as the backend CMS, the integration works identically — content is created in your Wix Content Manager and consumed by your frontend via the Wix SDK.

No additional configuration is needed in Siftly. Your frontend will pick up new content the next time it fetches from Wix's Content Manager API.

***

## Where to apply Siftly's recommendations on Wix

Wix has a built-in **SEO panel** for each page and blog post. Here's where each field lives and how to apply Siftly's values.

### Meta Title

**Location:** Blog post editor → click **SEO** (left sidebar) → **Basics → SEO Title**

Wix renders this as the `<title>` tag. If left empty, Wix uses the post title.

Siftly pushes the post title via the API, which Wix uses as the default SEO title. To use a different meta title, edit it in the Wix SEO panel after publishing.

### Meta Description

**Location:** Blog post editor → **SEO → Basics → SEO Description**

Wix renders this as `<meta name="description">`. Siftly maps its meta description to the post excerpt, which Wix often uses as the default SEO description.

After publishing from Siftly, open the post in Wix and verify the SEO Description matches Siftly's recommendation.

### Open Graph Image / Social Share Image

**Location:** Blog post editor → **SEO → Social Share**

Wix auto-generates OG tags using the post's cover image and title. To override:

1. Open the post in Wix blog editor
2. Click **SEO → Social Share**
3. Upload a custom image for Facebook/Twitter sharing

<Tip>
  Set a **cover image** on your Wix blog post — Wix uses it as the default OG image. Upload it in the post editor header area.
</Tip>

### Canonical URL

**Location:** Blog post editor → **SEO → Advanced → Canonical URL**

Wix auto-generates canonical URLs. Override only for syndicated content.

<Note>
  Siftly does not push canonical URL overrides to Wix. The default permalink is correct for original content.
</Note>

### Tags & Categories

**Location:** Blog post editor → **Categories** and **Tags** panels in the right sidebar.

Siftly pushes keywords as Wix **Hashtags** automatically. After publishing, you can add Wix-native categories in the post editor.

### JSON-LD Structured Data

Wix auto-generates basic structured data (Article schema) for blog posts. For supplemental schema (FAQ, HowTo, Product):

**Location:** Blog post editor → **SEO → Advanced → Additional structured data markup** (or **Structured Data** section)

<Warning>
  Custom JSON-LD / structured data markup requires a **Wix Premium plan** (Business or higher). Free plans do not expose the Advanced SEO settings.
</Warning>

To add Siftly's JSON-LD recommendation:

1. Open the post in Wix blog editor
2. Click **SEO → Advanced**
3. In the **Structured Data** section, paste Siftly's JSON-LD:

```json theme={null}
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is generative engine optimization?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "GEO is the practice of optimizing content to be cited by AI-powered search engines."
      }
    }
  ]
}
```

<Note>
  Wix expects raw JSON (no `<script>` tags) in the Structured Data field. It wraps it in the `<script type="application/ld+json">` tag automatically.
</Note>

### Keywords

Wix does not render a `<meta name="keywords">` tag. Keywords are handled through the Hashtags system, which appears in the post URL and helps with Wix's internal search.

***

## Pushing Siftly recommendations automatically

<Steps>
  <Step title="Generate content in Siftly">
    Siftly produces your article plus meta title, meta description, keywords, and JSON-LD.
  </Step>

  <Step title="Click Publish → Wix">
    Content is created as a draft in your Wix blog.
  </Step>

  <Step title="Fields auto-populated">
    Title, slug, body, excerpt (meta description), and hashtags (keywords) are pushed automatically.
  </Step>

  <Step title="Apply remaining fields manually in Wix">
    Open the draft in Wix blog editor. Apply Siftly's JSON-LD in **SEO → Advanced → Structured Data**. Upload a cover image. Review the SEO title. Then click **Publish** in Wix.
  </Step>
</Steps>

***

## Platform-specific quirks & limitations

<Warning>
  **All posts are created as drafts.** Wix's Blog API creates posts in draft status regardless of what you select in Siftly. You MUST open Wix to publish the post live.
</Warning>

<Warning>
  **Structured Data requires paid plan.** The Advanced SEO panel (including custom JSON-LD) is only available on Wix Business plans and higher. Free and basic plans cannot add custom structured data.
</Warning>

<Note>
  **No API access to SEO fields.** Wix's Blog API does not accept meta title, meta description, or JSON-LD values directly. These must be set manually in the Wix editor after Siftly creates the draft.
</Note>

* **Custom fields not supported:** Wix's Blog API has a fixed schema. Custom CMS fields defined in Siftly are stored locally for reference only — they are not sent to Wix.
* **Ricos format:** Wix uses its own rich text format (Ricos). Siftly converts HTML to Ricos automatically, but complex HTML (tables, iframes) may be stripped.
* **Cover image:** Must be uploaded manually in Wix after publishing from Siftly.
* **SEO auto-generation:** Wix generates basic Article schema automatically. Do NOT duplicate Article schema in the Structured Data field.
* **Multilingual:** Wix Multilingual sites require separate posts per language. Siftly publishes to the default language only.

***

## Validating the setup

After publishing from Siftly and making the post live in Wix:

<Steps>
  <Step title="View the live page source">
    Open your published Wix post in a browser. Right-click → **View Page Source**. Search for:

    * `<title>` — should contain your SEO title
    * `<meta name="description"` — should contain your meta description
    * `<script type="application/ld+json">` — should show Wix's auto-generated schema plus any custom schema you added
  </Step>

  <Step title="Run Google Rich Results Test">
    Go to [Google Rich Results Test](https://search.google.com/test/rich-results) and paste your post URL.
  </Step>

  <Step title="Run Schema.org Validator">
    Go to [Schema.org Validator](https://validator.schema.org/) for additional validation.
  </Step>

  <Step title="Check Wix SEO panel">
    In Wix editor, open the post → **SEO** panel. Verify the title, description, and structured data are all populated correctly.
  </Step>
</Steps>

***

## Difficulty & setup recap

<Card title="Wix Setup Summary" icon="w">
  | Aspect                  | Rating                                                      |
  | ----------------------- | ----------------------------------------------------------- |
  | **Initial setup**       | ✅ Easy — API key generation, no code                        |
  | **Applying SEO fields** | ✅ Easy — visual SEO panel in post editor                    |
  | **JSON-LD**             | ⚠️ Requires paid plan; must be added manually after publish |
  | **Ongoing editing**     | ⚠️ Posts created as drafts — requires manual publish in Wix |
  | **Developer needed?**   | No                                                          |
</Card>

***

## Related

<CardGroup cols={2}>
  <Card title="CMS Integrations Overview" icon="grid-2" href="/integrations/overview">
    Compare all supported platforms and the unified field mapping system.
  </Card>

  <Card title="Quickstart Guide" icon="rocket" href="/quickstart">
    Set up your brand and run your first GEO analysis.
  </Card>

  <Card title="Content Generation" icon="file-pen" href="/features/content-generation">
    How Siftly generates GEO-optimized content and recommendations.
  </Card>

  <Card title="Choosing a CMS for AI Visibility" icon="book" href="https://siftly.ai/blog/cms-and-ai-visibility">
    Our guide to picking the right CMS for GEO optimization.
  </Card>
</CardGroup>