Co jest najważniejsze przy migracji WordPressa do Next.js?

Najważniejsze jest pełne mapowanie starych URL-i, poprawne redirecty 301, zachowanie metadanych, migracja obrazów i kontrola indeksacji po wdrożeniu. Bez tego łatwo stracić ruch organiczny.

Czy można zmienić strukturę URL podczas migracji?

Można, ale każda zmiana powinna mieć jednoznaczny redirect 301 ze starego adresu na nowy. Przy większych serwisach warto przygotować mapę URL-i i przetestować ją przed deployem.

Kiedy sprawdzić efekty migracji w Google Search Console?

Pierwsze błędy warto sprawdzać od razu po wdrożeniu, ale stabilna ocena indeksacji i ruchu organicznego wymaga zwykle kilku dni lub tygodni, zależnie od wielkości serwisu.

Jak długo trwa spadek ruchu po migracji?

Z redirectami i tymi samymi URL spadek o 5–15% to czas, w którym algorytm sprawdza, czy nowy kod Next.js renderuje tę samą treść i czy jest stabilny. Trwa to zazwyczaj 2–4 tygodnie. Bez redirectów to trzęsienie ziemi i tracisz 50–80% ruchu, ponieważ Google uznaje, że stara treść zniknęła, a nowa nie ma żadnej historii.

Czy muszę migrować komentarze?

Raczej sugerowałbym ich eksport, ponieważ są naturalną formą wyrazu obecności użytkowników na Twojej stronie internetowej. Więc można powiedzieć, że jakąś wartość SEO zawsze mają, chyba że wyglądają jak spam.

Czy mogę utrzymać WordPress jako CMS i przenieść frontend?

Tak, jest to podejście headless. WordPress zostaje jako CMS, czyli zarządzanie treścią, a Next.js przejmuje frontend i w ten sposób nie musimy robić migracji treści czy zmieniać struktur workflow redakcyjnego.

Migracja z WordPress do Next.js — redirecty 301 i pozycje SEO

Co decyduje o tym, czy migracja zachowa SEO

Migracja z WordPress na Next.js to dobra i przyszłościowa inwestycja — szybsza strona, lepsze Core Web Vitals, zmniejszenie ryzyka narażenia na ataki i pełna kontrola nad kodem. O tym, czy zachowasz pozycje w Google, decyduje przemyślany, dobry plan SEO. Z dobrym planem przejście jest niemal niewidoczne dla wyszukiwarki, a bez niego ryzykujesz to, na co pracowałeś latami.

Cały ciężar spoczywa na URL-ach, które Google zaindeksował, przypisał im autorytet i rankuje na konkretne frazy. Zabezpieczysz je — migracja jest niewidoczna dla algorytmu. Pominiesz je — konsekwencje są cztery:

utracone pozycje — Google widzi nowe URL-e jako nowe strony, bez wieloletniej historii,
błędy 404 — stare adresy przestają działać,
utratę backlinków — linki zewnętrzne prowadzą donikąd,
spadek ruchu organicznego na tygodnie lub długie miesiące.

Migracja krok 1: Inwentaryzacja tego co aktualnie masz w WordPress

Przed migracją zrób pełną, dokładną listę zaindeksowanych stron:

Code

# Pobierz wszystkie zaindeksowane URL-e z Google Search Console
# GSC → Performance → Pages → Eksportuj do CSV
 
# Lub użyj screaming frog / sitemap
curl -s https://twoj-wordpress.pl/sitemap_index.xml

Następnie stwórz arkusz z czterema kolumnami: stary URL, nowy URL, status (migruj//usuń) oraz priorytet (ruch organiczny).

Migracja krok 2: Eksport treści z WordPress

Code

# WP-CLI — eksport do JSON (najlepsze do programowej migracji)
wp post list --post_type=post --format=json --fields=ID,post_title,post_name,post_content,post_date,post_excerpt > posts.json
wp post list --post_type=page --format=json --fields=ID,post_title,post_name,post_content > pages.json
 
# Eksport mediów
wp media list --format=json --fields=ID,guid,post_title,alt_text > media.json

Alternatywą jest użycie WordPress :

Code

// scripts/export-wordpress.ts
async function exportPosts() {
  let page = 1
  let allPosts: any[] = []
 
  while (true) {
    const res = await fetch(
      `https://twoj-wordpress.pl/wp-json/wp/v2/posts?per_page=100&page=${page}&_embed`,
    )
 
    if (!res.ok) break
 
    const posts = await res.json()
    if (posts.length === 0) break
 
    allPosts = [...allPosts, ...posts]
    page++
  }
 
  // Zapisz do pliku
  const fs = require('fs')
  fs.writeFileSync('wordpress-posts.json', JSON.stringify(allPosts, null, 2))
  console.log(`Wyeksportowano ${allPosts.length} postów`)
}

Migracja krok 3: Konwersja treści na MDX (lub import do CMS)

Code

// scripts/convert-to-mdx.ts
import TurndownService from 'turndown'
import fs from 'fs'
import path from 'path'
 
const turndown = new TurndownService({
  headingStyle: 'atx',
  codeBlockStyle: 'fenced',
})
 
interface WPPost {
  title: { rendered: string }
  slug: string
  content: { rendered: string }
  excerpt: { rendered: string }
  date: string
  _embedded?: {
    'wp:featuredmedia'?: [{ source_url: string; alt_text: string }]
    'wp:term'?: [{ name: string }[]]
  }
}
 
function convertPost(post: WPPost): string {
  const tags = post._embedded?.['wp:term']?.[0]?.map((t) => t.name) || []
  const image = post._embedded?.['wp:featuredmedia']?.[0]?.source_url || ''
  const excerpt = post.excerpt.rendered.replace(/<[^>]*>/g, '').trim()
 
  // Konwersja HTML → Markdown
  const content = turndown.turndown(post.content.rendered)
 
  // Frontmatter MDX
  const frontmatter = `---
title: '${post.title.rendered.replace(/'/g, "\\'")}'
description: '${excerpt.slice(0, 160)}'
datePublished: '${post.date}'
author: 'Maciej Sala'
tags: [${tags.map((t) => `'${t}'`).join(', ')}]
---`
 
  return `${frontmatter}\n\n${content}`
}
 
// Konwertuj wszystkie posty
const posts: WPPost[] = JSON.parse(
  fs.readFileSync('wordpress-posts.json', 'utf-8'),
)
 
for (const post of posts) {
  const mdx = convertPost(post)
  const filePath = path.join('content/blog', `${post.slug}.mdx`)
  fs.writeFileSync(filePath, mdx)
}
 
console.log(`Skonwertowano ${posts.length} postów do MDX`)

Migracja krok 4: Mapowanie URL-i i redirecty 301

Kluczowym zadaniem jest zapewnienie, że każdy stary URL ma swój odpowiednik w nowej witrynie, dlatego jeśli jest taka możliwość - zachowaj strukturę URL. Jeśli zmiany nie da się uniknąć, musisz skonfigurować przekierowania 301 (permanent redirect) ze starych adresów na nowe.

Code

// Typowe mapowanie WordPress → Next.js
const urlMap: Record<string, string> = {
  // WordPress domyślne
  '/wp-admin': null, // Nie przekierowuj
  '/wp-login.php': null, // Nie przekierowuj
  '/feed': '/blog/rss.xml', // RSS
 
  // Struktury permalink
  // WordPress: /2024/01/moj-post/ → Next.js: /blog/moj-post
  // WordPress: /kategoria/nazwa/ → Next.js: /blog?tag=nazwa
}

Code

// next.config.ts
const nextConfig = {
  async redirects() {
    return [
      // Redirect WordPress permalink structure
      {
        source: '/:year(\\d{4})/:month(\\d{2})/:slug',
        destination: '/blog/:slug',
        permanent: true, // 301
      },
      // Redirect category pages
      {
        source: '/category/:slug',
        destination: '/blog?tag=:slug',
        permanent: true,
      },
      // Redirect tag pages
      {
        source: '/tag/:slug',
        destination: '/blog?tag=:slug',
        permanent: true,
      },
      // Redirect feed
      {
        source: '/feed',
        destination: '/blog/rss.xml',
        permanent: true,
      },
      // WordPress artifacts
      {
        source: '/wp-content/:path*',
        destination: '/images/:path*', // Jeśli przeniosłeś media
        permanent: true,
      },
      // Konkretne strony z innym URL
      {
        source: '/o-nas',
        destination: '/o-mnie',
        permanent: true,
      },
    ]
  },
}

Migracja krok 5: Migracja obrazów

Code

// scripts/download-images.ts
import fs from 'fs'
import path from 'path'
 
const media: { guid: string; post_title: string }[] = JSON.parse(
  fs.readFileSync('media.json', 'utf-8'),
)
 
async function downloadImage(url: string, filename: string) {
  const res = await fetch(url)
  const buffer = await res.arrayBuffer()
  const outputPath = path.join('public/images/blog', filename)
  fs.writeFileSync(outputPath, Buffer.from(buffer))
}
 
async function migrateImages() {
  for (const item of media) {
    const url = item.guid
    const filename = path.basename(new URL(url).pathname)
 
    try {
      await downloadImage(url, filename)
      console.log(`✓ ${filename}`)
    } catch {
      console.error(`✗ ${filename}`)
    }
  }
}

Po pobraniu kolejny krok to zaktualizowanie lokalnych linków do obrazków w :

Code

# Zamień stare URL-e mediów na lokalne ścieżki
sed -i 's|https://twoj-wordpress.pl/wp-content/uploads/|/images/blog/|g' content/blog/*.mdx

Migracja krok 6: Weryfikacja przed przełączeniem

Lista działań do odchaczenia przed przełączeniem:

Każdy stary URL posiada redirect 301 lub odpowiednik w nowej strukturze
Sitemap zawiera wszystkie zmigrowane strony
Meta tagi (title, description) są poprawnie zachowane z WordPressa
Obrazy zostały przeniesione i są dostępne
Schema.org / zostały poprawnie zachowane lub odtworzone
Canonical URL-e są poprawne
robots.txt nie blokuje ważnych ścieżek
Google Search Console zostało poprawnie zweryfikowane na nowej stronie

Krok 7: Przełączenie i monitoring

Pierwszym krokiem jest wdrożenie nowej strony Next.js,
Następnie przekieruj domenę na nowy hosting,
Sprawdź redirecty (curl -I stare-url → 301 → nowy-url),
Zgłoś nową sitemap w Google Search Console,
Użyj URL Inspection na kluczowych stronach,
Monitoruj uważnie ruch w przez 4-6 tygodni.

Spadek ruchu o 10–20% w pierwszym tygodniu jest normalny — Google musi przeindeksować nową strukturę. Sytuacja stabilizuje się w ciągu kolejnych 2–6 tygodni.

Co decyduje o tym, czy migracja zachowa SEO

utracone pozycje — Google widzi nowe URL-e jako nowe strony, bez wieloletniej historii,
błędy 404 — stare adresy przestają działać,
utratę backlinków — linki zewnętrzne prowadzą donikąd,
spadek ruchu organicznego na tygodnie lub długie miesiące.

Migracja krok 1: Inwentaryzacja tego co aktualnie masz w WordPress

Przed migracją zrób pełną, dokładną listę zaindeksowanych stron:

Code

# Pobierz wszystkie zaindeksowane URL-e z Google Search Console
# GSC → Performance → Pages → Eksportuj do CSV
 
# Lub użyj screaming frog / sitemap
curl -s https://twoj-wordpress.pl/sitemap_index.xml

Następnie stwórz arkusz z czterema kolumnami: stary URL, nowy URL, status (migruj//usuń) oraz priorytet (ruch organiczny).

Migracja krok 2: Eksport treści z WordPress

Code

# WP-CLI — eksport do JSON (najlepsze do programowej migracji)
wp post list --post_type=post --format=json --fields=ID,post_title,post_name,post_content,post_date,post_excerpt > posts.json
wp post list --post_type=page --format=json --fields=ID,post_title,post_name,post_content > pages.json
 
# Eksport mediów
wp media list --format=json --fields=ID,guid,post_title,alt_text > media.json

Alternatywą jest użycie WordPress :

Code

// scripts/export-wordpress.ts
async function exportPosts() {
  let page = 1
  let allPosts: any[] = []
 
  while (true) {
    const res = await fetch(
      `https://twoj-wordpress.pl/wp-json/wp/v2/posts?per_page=100&page=${page}&_embed`,
    )
 
    if (!res.ok) break
 
    const posts = await res.json()
    if (posts.length === 0) break
 
    allPosts = [...allPosts, ...posts]
    page++
  }
 
  // Zapisz do pliku
  const fs = require('fs')
  fs.writeFileSync('wordpress-posts.json', JSON.stringify(allPosts, null, 2))
  console.log(`Wyeksportowano ${allPosts.length} postów`)
}

Migracja krok 3: Konwersja treści na MDX (lub import do CMS)

Code

// scripts/convert-to-mdx.ts
import TurndownService from 'turndown'
import fs from 'fs'
import path from 'path'
 
const turndown = new TurndownService({
  headingStyle: 'atx',
  codeBlockStyle: 'fenced',
})
 
interface WPPost {
  title: { rendered: string }
  slug: string
  content: { rendered: string }
  excerpt: { rendered: string }
  date: string
  _embedded?: {
    'wp:featuredmedia'?: [{ source_url: string; alt_text: string }]
    'wp:term'?: [{ name: string }[]]
  }
}
 
function convertPost(post: WPPost): string {
  const tags = post._embedded?.['wp:term']?.[0]?.map((t) => t.name) || []
  const image = post._embedded?.['wp:featuredmedia']?.[0]?.source_url || ''
  const excerpt = post.excerpt.rendered.replace(/<[^>]*>/g, '').trim()
 
  // Konwersja HTML → Markdown
  const content = turndown.turndown(post.content.rendered)
 
  // Frontmatter MDX
  const frontmatter = `---
title: '${post.title.rendered.replace(/'/g, "\\'")}'
description: '${excerpt.slice(0, 160)}'
datePublished: '${post.date}'
author: 'Maciej Sala'
tags: [${tags.map((t) => `'${t}'`).join(', ')}]
---`
 
  return `${frontmatter}\n\n${content}`
}
 
// Konwertuj wszystkie posty
const posts: WPPost[] = JSON.parse(
  fs.readFileSync('wordpress-posts.json', 'utf-8'),
)
 
for (const post of posts) {
  const mdx = convertPost(post)
  const filePath = path.join('content/blog', `${post.slug}.mdx`)
  fs.writeFileSync(filePath, mdx)
}
 
console.log(`Skonwertowano ${posts.length} postów do MDX`)

Migracja krok 4: Mapowanie URL-i i redirecty 301

Code

// Typowe mapowanie WordPress → Next.js
const urlMap: Record<string, string> = {
  // WordPress domyślne
  '/wp-admin': null, // Nie przekierowuj
  '/wp-login.php': null, // Nie przekierowuj
  '/feed': '/blog/rss.xml', // RSS
 
  // Struktury permalink
  // WordPress: /2024/01/moj-post/ → Next.js: /blog/moj-post
  // WordPress: /kategoria/nazwa/ → Next.js: /blog?tag=nazwa
}

Code

// next.config.ts
const nextConfig = {
  async redirects() {
    return [
      // Redirect WordPress permalink structure
      {
        source: '/:year(\\d{4})/:month(\\d{2})/:slug',
        destination: '/blog/:slug',
        permanent: true, // 301
      },
      // Redirect category pages
      {
        source: '/category/:slug',
        destination: '/blog?tag=:slug',
        permanent: true,
      },
      // Redirect tag pages
      {
        source: '/tag/:slug',
        destination: '/blog?tag=:slug',
        permanent: true,
      },
      // Redirect feed
      {
        source: '/feed',
        destination: '/blog/rss.xml',
        permanent: true,
      },
      // WordPress artifacts
      {
        source: '/wp-content/:path*',
        destination: '/images/:path*', // Jeśli przeniosłeś media
        permanent: true,
      },
      // Konkretne strony z innym URL
      {
        source: '/o-nas',
        destination: '/o-mnie',
        permanent: true,
      },
    ]
  },
}

Migracja krok 5: Migracja obrazów

Code

// scripts/download-images.ts
import fs from 'fs'
import path from 'path'
 
const media: { guid: string; post_title: string }[] = JSON.parse(
  fs.readFileSync('media.json', 'utf-8'),
)
 
async function downloadImage(url: string, filename: string) {
  const res = await fetch(url)
  const buffer = await res.arrayBuffer()
  const outputPath = path.join('public/images/blog', filename)
  fs.writeFileSync(outputPath, Buffer.from(buffer))
}
 
async function migrateImages() {
  for (const item of media) {
    const url = item.guid
    const filename = path.basename(new URL(url).pathname)
 
    try {
      await downloadImage(url, filename)
      console.log(`✓ ${filename}`)
    } catch {
      console.error(`✗ ${filename}`)
    }
  }
}

Po pobraniu kolejny krok to zaktualizowanie lokalnych linków do obrazków w :

Code

# Zamień stare URL-e mediów na lokalne ścieżki
sed -i 's|https://twoj-wordpress.pl/wp-content/uploads/|/images/blog/|g' content/blog/*.mdx

Migracja krok 6: Weryfikacja przed przełączeniem

Lista działań do odchaczenia przed przełączeniem:

Każdy stary URL posiada redirect 301 lub odpowiednik w nowej strukturze
Sitemap zawiera wszystkie zmigrowane strony
Meta tagi (title, description) są poprawnie zachowane z WordPressa
Obrazy zostały przeniesione i są dostępne
Schema.org / zostały poprawnie zachowane lub odtworzone
Canonical URL-e są poprawne
robots.txt nie blokuje ważnych ścieżek
Google Search Console zostało poprawnie zweryfikowane na nowej stronie

Krok 7: Przełączenie i monitoring

Pierwszym krokiem jest wdrożenie nowej strony Next.js,
Następnie przekieruj domenę na nowy hosting,
Sprawdź redirecty (curl -I stare-url → 301 → nowy-url),
Zgłoś nową sitemap w Google Search Console,
Użyj URL Inspection na kluczowych stronach,
Monitoruj uważnie ruch w przez 4-6 tygodni.

Spadek ruchu o 10–20% w pierwszym tygodniu jest normalny — Google musi przeindeksować nową strukturę. Sytuacja stabilizuje się w ciągu kolejnych 2–6 tygodni.

Migracja z WordPress do Next.js — redirecty 301 i pozycje SEO

Co decyduje o tym, czy migracja zachowa SEO

Migracja krok 1: Inwentaryzacja tego co aktualnie masz w WordPress

Migracja krok 2: Eksport treści z WordPress

Migracja krok 3: Konwersja treści na MDX (lub import do CMS)

Migracja krok 4: Mapowanie URL-i i redirecty 301

Migracja krok 5: Migracja obrazów

Migracja krok 6: Weryfikacja przed przełączeniem

Krok 7: Przełączenie i monitoring

Czytaj dalej

Migracja z WordPress do Next.js — redirecty 301 i pozycje SEO

Co decyduje o tym, czy migracja zachowa SEO

Migracja krok 1: Inwentaryzacja tego co aktualnie masz w WordPress

Migracja krok 2: Eksport treści z WordPress

Migracja krok 3: Konwersja treści na MDX (lub import do CMS)

Migracja krok 4: Mapowanie URL-i i redirecty 301

Migracja krok 5: Migracja obrazów

Migracja krok 6: Weryfikacja przed przełączeniem

Krok 7: Przełączenie i monitoring

Czytaj dalej