Podłączenie Wix

Zanim zaczniesz: czy w ogóle dasz radę

To najtrudniejsza z naszych integracji i nie chcemy udawać, że jest inaczej.

Krótka odpowiedź: da się, i nie trzeba do tego zostawać programistą Wix. Nie zakładasz żadnego konta deweloperskiego, nie zgłaszasz aplikacji, nie piszesz ani linijki kodu. Ale to nie są trzy kliknięcia i nie chcemy, żebyś się o tym dowiedział w połowie. Poniżej cztery rzeczy, które trzeba wiedzieć, zanim zaczniesz.

Klucz musi wygenerować właściciel konta Wix. Twarda zasada dotyczy tego, skąd klucz pochodzi: musi powstać na tym koncie Wix, do którego należy witryna. Klucz z Twojego własnego, osobnego konta nie zadziała, nawet jeśli masz do strony pełny dostęp. Tak jest wtedy, gdy stronę prowadzi dla Ciebie agencja albo gdy dostałeś zaproszenie do cudzego konta. Dzisiejsza dokumentacja Wix mówi, że w obrębie konta właściciela nie ma znaczenia, który jego członek wygenerował klucz, ale starsza strona Wix nadal twierdzi, że klucz współwłaściciela zostanie odrzucony. Klucz samego właściciela konta działa zawsze, więc najprościej poprosić właściciela, żeby przeszedł przez tę instrukcję i przekazał Ci gotowy klucz.
To jest dziesięć kroków w panelu Wix, nie trzy. Wszystkie dziesięć idzie na sam klucz API. Identyfikatora witryny zwykle nie musisz już nigdzie szukać, bo witrynę znajdujemy sami. Wix nie ma przycisku „połącz z aplikacją”, który zrobiłby to za Ciebie: klucz generuje się ręcznie, uprawnienia zaznacza ręcznie, a całość potwierdza kodem weryfikacyjnym. Zajmuje to około kwadransa.
Klucz zobaczysz jeden raz. Wix pokazuje go w okienku po wygenerowaniu i nigdy więcej. Jeśli zamkniesz okno bez skopiowania, klucz jest bezpowrotnie stracony i trzeba wygenerować nowy.
Ten klucz to poważne uprawnienie. Klucz API Wix działa na poziomie konta i domyślnie sięga do wszystkich witryn. W kroku o dostępie do witryn pokazujemy, jak zawęzić go do jednej strony, i zdecydowanie prosimy, żebyś to zrobił. My potrzebujemy tylko tej jednej.

Co dostaniesz, a czego Wix nie umie

API bloga Wix jest węższe niż WordPress i nie zamierzamy sugerować, że jest inaczej. To jest pełna lista, sprawdzona na opublikowanym wpisie, a nie przepisana z dokumentacji.

Co trafi na Twojego bloga

Tytuł wpisu.
Całą treść artykułu, z nagłówkami, akapitami, listami, tabelami i odnośnikami. Odnośnik zachowuje swój rel, sami nie dokładamy nofollow. Wix przekształca treść do swojego własnego formatu po swojej stronie.
Zdjęcia w środku artykułu, zaimportowane do Twojego Menedżera multimediów, a nie podlinkowane z cudzego serwera.
Zdjęcie główne, też zaimportowane do Twojego Menedżera multimediów.
Zajawkę, czyli krótki opis widoczny na liście wpisów.
Tytuł SEO, opis meta i znaczniki Open Graph. Wpis Wix ma pole „seoData” z listą znaczników, i my je wypełniamy, zamiast zostawiać Wixowi zgadywanie z zajawki.
Adres wpisu. Wix trzyma wpisy pod „/post/”, a końcówkę wysyłamy w polu „seoSlug”, dobraną pod frazę, a nie przepisaną z tytułu.
Kategorie, o ile podasz ich identyfikatory i o ile już istnieją na blogu.
Publikację od razu albo zostawienie wpisu jako szkicu do Twojej akceptacji.

Czego nie ustawimy, bo API tego nie przyjmuje

Tworzenia nowych kategorii. Umiemy wpiąć wpis w kategorię, która już jest, ale nie umiemy jej założyć.
Autora spoza listy członków witryny. Wix żąda przy wpisie identyfikatora członka, więc autor musi istnieć w Twojej witrynie albo musimy go założyć, i do tego służą uprawnienia do członków opisane niżej.

Piszemy to wprost, bo wygodniej byłoby przemilczeć. Wix jest tu węższy niż WordPress, ale nie w rubryce SEO: tytuł SEO, opis SEO i adres wpisu ustawiamy sami i nie musisz ich poprawiać ręcznie po publikacji.

Autorem wpisów jest profil właściciela witryny, o ile taki profil istnieje. Wix traktuje właściciela jak zarejestrowanego użytkownika strony, więc zwykle po prostu go odnajdujemy. Nazwa widoczna pod wpisami to nazwa wyświetlana tego profilu i możesz ją zmienić u siebie w Wix, bez pytania nas o zgodę.

Darmowy plan Wix wystarczy, sprawdziliśmy to na takiej właśnie stronie. Liczy się co innego: witryna musi być opublikowana i musi mieć dodaną aplikację Wix Blog.

Czego potrzebujesz

Dostępu do konta Wix, do którego należy witryna, najlepiej jako jego właściciel.
Telefonu albo skrzynki e-mail, na którą Wix wyśle kod weryfikacyjny przy generowaniu klucza.
Bloga Wix dodanego do witryny i witryny opublikowanej. Jeśli na stronie nie ma jeszcze bloga, dodaj go w edytorze i opublikuj stronę, zanim zaczniesz; bez tego klucz nie będzie miał czego obsłużyć.
Kwadransa spokoju, bo klucza nie da się zapisać w połowie i wrócić do niego później.

Krok po kroku: klucz API

Zaloguj się na Wix na koncie, do którego należy witryna, najlepiej jako jego właściciel.
Wejdź na manage.wix.com/account/api-keys. To jest Menedżer kluczy API. Można tam też dojść przez ustawienia konta, ale adres jest pewniejszy niż szukanie pozycji w menu.
Na tej stronie widnieje też identyfikator konta. Nam nie jest potrzebny, więc go pomiń; odczytujemy go sami z klucza.
Kliknij przycisk generowania nowego klucza.
Nadaj kluczowi nazwę, po której go poznasz, na przykład „Publikacja artykułów”.
Zaznacz uprawnienia. To najważniejszy krok i najczęstsze miejsce, w którym coś się gubi. Potrzebujemy pięciu grup, a przy sklepie sześciu. Lista jest poniżej.
Ustaw dostęp do witryn. Wybierz opcję dla wskazanych witryn i dodaj tylko tę jedną stronę, na której mamy publikować. Opcja „wszystkie witryny” też zadziała, ale daje kluczowi więcej, niż potrzebuje.
Zatwierdź. Wix poprosi o kod weryfikacyjny. Wysyła go e-mailem albo SMS-em, zależnie od konta.
Skopiuj klucz z okienka, które się pokaże, i wklej go od razu w bezpieczne miejsce. Zobaczysz go tylko ten jeden raz.
Zamknij okienko dopiero wtedy, gdy klucz masz skopiowany.

Co ma być widoczne: Menedżer kluczy API na manage.wix.com/account/api-keys, z widocznym przyciskiem generowania nowego klucza i listą kluczy już istniejących.

Uprawnienia do zaznaczenia

Panel Wix nie pokazuje nazw zakresów API. Lista uprawnień jest pogrupowana produktami, a na polskim koncie nazwy grup są przetłumaczone. Dlatego przy każdej pozycji podajemy najpierw nazwę tak, jak ją widzisz, potem tę samą nazwę w drugim języku, a na końcu zakres API, na wypadek gdyby Wix znowu zmienił etykietę.

Blog Wix (w panelu po angielsku: Wix Blog; zakres API: Manage Blog) - Wymagane. Utworzenie wpisu i jego publikacja. Bez tego nie zrobimy nic.
Ricos Dokumenty (w panelu po angielsku: Ricos Documents; zakres API: Manage Ricos Document) - Wymagane. Przekształcenie treści artykułu do formatu, w którym Wix trzyma wpisy. To osobne uprawnienie od bloga i najczęściej pomijane. Bez niego połączenie się zestawi, a każdy artykuł polegnie.
Zarządzaj mediami Stron (w panelu po angielsku: Manage Site Media; zakres API: Manage Media Manager) - Wymagane. Zdjęcie główne i zdjęcia w środku artykułu, wgrane do Twojego Menedżera multimediów. Od teraz odrzucamy klucz bez tego uprawnienia, bo artykuł bez zdjęć jest gorszym artykułem.
Wix Kontakty i Użytkownicy (w panelu po angielsku: Wix Contacts & Members; zakres API: Read Members) - Wymagane. Wix wymaga od klucza API identyfikatora członka witryny jako autora wpisu. Tym uprawnieniem odnajdujemy autora, który już u Ciebie jest.
Zarządzaj zarejestrowanymi użytkownikami (w panelu po angielsku: Manage Site Members; zakres API: Manage Members) - Wymagane. Gdy pasującego autora w witrynie nie ma, zakładamy go raz, żeby wpisy miały do kogo należeć. Bez tego uprawnienia zatrzymamy się na pierwszym artykule.
Wix Stores (w panelu po angielsku: Wix Stores; zakres API: Read Products, Read Categories) - Tylko ze sklepem. Odczyt katalogu Wix Stores, żeby artykuły mogły odsyłać do Twoich produktów. Bez sklepu pomiń.

Klucz z tymi pięcioma grupami sprawdziliśmy 19 września 2026 na prawdziwej witrynie Wix i wszystko zadziałało: połączenie, artykuł ze zdjęciem głównym i zdjęciem w treści oraz ustawiony tytuł SEO, opis SEO i adres wpisu. Przy każdym kluczu jest też podstawowe uprawnienie do listy witryn konta, zaznaczone na stałe i niemożliwe do odznaczenia; zostaw je tak, jak jest. Gdyby któraś nazwa brzmiała w Twoim panelu inaczej, kieruj się opisem obok, bo Wix zmienia etykiety częściej niż zakresy API.

Co ma być widoczne: Okno wyboru uprawnień przy generowaniu klucza, z zaznaczonymi pięcioma grupami: „Blog Wix”, „Ricos Dokumenty”, „Zarządzaj mediami Stron”, „Wix Kontakty i Użytkownicy” oraz „Zarządzaj zarejestrowanymi użytkownikami”.

Co ma być widoczne: Sekcja dostępu do witryn w tym samym oknie, z wybraną opcją wskazanych witryn i jedną stroną na liście.

Co ma być widoczne: Okienko z wygenerowanym kluczem i ostrzeżeniem, że zobaczy się go tylko raz.

Identyfikator witryny, zwykle niepotrzebny

Pole identyfikatora witryny możesz zostawić puste. Każdy klucz API Wix umie wylistować witryny konta, więc szukamy jej sami: jeśli na koncie jest jedna witryna, bierzemy ją; jeśli kilka, dopasowujemy po adresie Twojej strony, a pytamy dopiero wtedy, gdy to się nie uda. Cały adres panelu witryny też przyjmiemy, bo sami wyłuskamy z niego identyfikator.

Jeśli na koncie masz kilka witryn i wolisz wskazać właściwą od razu, jej identyfikator odczytasz z adresu panelu:

Otwórz panel tej witryny, na której mamy publikować.
Spójrz na adres w przeglądarce. Ma postać manage.wix.com/dashboard/<identyfikator>/home.
Skopiuj to, co stoi zaraz za /dashboard/, aż do następnego ukośnika. To 36 znaków z czterema myślnikami, wyglądające tak: 3ecba886-4267-11ee-be56-0242ac120002.
Cały adres panelu też możesz wkleić, identyfikator wyciągniemy z niego sami.

Co ma być widoczne: Pasek adresu przeglądarki na panelu witryny, z zaznaczonym fragmentem identyfikatora zaraz za /dashboard/.

Wklejenie u nas i test

We wdrożeniu, w kroku Publikacja, kliknij kafelek Wix, a pola rozwiną się pod siatką kafelków. To samo zrobisz później w Witrynach: otwierasz witrynę i wybierasz Podłącz: Publikowanie, a na liście platform wskazujesz Wix.
W polu klucza API wklej to, co skopiowałeś z okienka Wix.
Pole identyfikatora witryny zostaw puste, a witrynę znajdziemy sami. Wypełnij je tylko wtedy, gdy na koncie Wix masz kilka stron i chcesz od razu wskazać właściwą.
Kliknij Sprawdź i połącz. Testujemy połączenie od razu, a wynik, razem z ewentualnym komunikatem o błędzie, pokazujemy w tym samym panelu, pod polami.

Jeśli wszystko jest na miejscu, zobaczysz potwierdzenie, że połączyliśmy się z Wix, oraz zdanie o tym, czy na stronie jest sklep. Brak sklepu jest w porządku i nie jest błędem. Gdy na koncie jest więcej niż jedna witryna i nie umiemy dopasować właściwej po adresie, poprosimy o wskazanie jednej z listy.

Jeśli coś nie gra, powiemy które. Sekcja na końcu tej strony tłumaczy każdą z tych odpowiedzi.

Kiedy połączenie działa, na stronie witryny pojawia się przycisk Wyślij artykuł testowy. Publikujemy wtedy jeden krótki, wyraźnie oznaczony artykuł tym samym połączeniem, którym pójdą wszystkie następne, więc w kilka minut widzisz na swoim blogu Wix, że cała droga działa. Chwilę później sami go usuwamy, więc nie zostaje u Ciebie nic do sprzątania. Jeśli utkniesz, napisz na hello@justrank.it.

Sklep Wix Stores, jeśli go masz

Kiedy na stronie działa Wix Stores, a klucz ma uprawnienia do odczytu produktów i kategorii, umiemy wczytać Twój katalog i pozwolić artykułom odsyłać do konkretnych produktów. Sprawdzamy to sami przy teście połączenia.

Jeśli sklepu nie masz, nic się nie psuje. Napiszemy tylko, że synchronizacja katalogu jest niedostępna, i wszystko inne działa dalej. Strona firmowa z blogiem to normalny przypadek, nie awaria.

Jedno ograniczenie: API Wix nie zwraca adresów stron kategorii sklepowych, więc kategorie zaczytujemy z nazwami i strukturą, ale bez odnośników. Produkty mają swoje adresy normalnie.

Ustawienia dodatkowe

Tryb szkicu. Możesz poprosić, żebyśmy zostawiali wpisy jako szkice zamiast publikować od razu. Wtedy artykuł pojawia się w panelu bloga Wix i czeka, aż go zaakceptujesz. Kolejne poprawki treści też zostają w szkicu.
Kategorie. Podaj identyfikatory kategorii, do których mają trafiać wpisy, a będziemy je przypisywać. Kategorii nieistniejących Wix po cichu nie doda, więc muszą być założone wcześniej na blogu.
Język wpisu. Przy blogu wielojęzycznym możemy oznaczać wpisy kodem języka.

Gdy coś nie działa

Poniżej są odpowiedzi, które faktycznie zobaczysz, i co za każdą z nich stoi.

Wix nie przyjął tego klucza API. Klucz jest zły, został usunięty albo przy kopiowaniu wszedł dodatkowy znak. Wygeneruj nowy klucz w Menedżerze kluczy API i wklej go ponownie, bez dodatkowych spacji.
To nie wygląda na cały klucz API Wix. Klucz urwał się przy kopiowaniu. Wklej cały, od liter IST do ostatniego znaku. Jeśli już go nie masz, wygeneruj nowy w Menedżerze kluczy API, bo Wix pokazuje klucz tylko raz.
Wix przyjął klucz, ale odmówił dostępu do tej witryny. Otwórz klucz w Menedżerze kluczy API i sprawdź trzy rzeczy: czy zaznaczone jest uprawnienie „Blog Wix”, czy ta witryna jest na liście witryn klucza i czy klucz został wygenerowany na koncie Wix, do którego należy witryna.
Wix nie zna witryny o takim identyfikatorze. Skopiuj identyfikator z adresu panelu witryny, czyli fragment zaraz za /dashboard/, albo zostaw pole puste, a sami znajdziemy witrynę.
To nie wygląda na identyfikator witryny Wix. Identyfikator ma 36 znaków i cztery myślniki, a kopiuje się go z adresu panelu witryny, zaraz za /dashboard/. Możesz też zostawić pole puste, a sami znajdziemy witrynę.
Ta witryna Wix nie ma jeszcze bloga. Dodaj aplikację Wix Blog w edytorze Wix, opublikuj witrynę i sprawdź połączenie ponownie. Dopóki zmiana nie jest opublikowana, blog nie odpowie.
Ten klucz API Wix nie widzi żadnej witryny. Klucz powstał na innym koncie Wix niż to, do którego należy witryna, albo nikt nie dodał tej witryny do listy witryn klucza. Wygeneruj klucz na koncie właściciela witryny i dodaj tę witrynę do listy.
Na tym koncie Wix jest więcej niż jedna witryna. Nie umieliśmy dopasować właściwej po adresie Twojej strony, więc pytamy. Wybierz tę, na której mamy publikować, albo wklej jej identyfikator w pole identyfikatora witryny.
Klucz nie może przekształcać artykułów w treść bloga. To brakujące uprawnienie „Ricos Dokumenty”. Blog odpowiada, ale sama treść nie ma jak powstać. Edytuj klucz w Menedżerze kluczy API i zaznacz je dodatkowo, obok „Blog Wix”.
Nie udało się znaleźć ani utworzyć autora wpisów. Wix wymaga od klucza API identyfikatora członka witryny jako autora wpisu. Edytuj klucz w Menedżerze kluczy API i zaznacz dodatkowo „Wix Kontakty i Użytkownicy”, żebyśmy umieli odnaleźć istniejącego autora, oraz „Zarządzaj zarejestrowanymi użytkownikami”, żebyśmy umieli go założyć, gdy go nie ma.
Klucz nie może dodawać zdjęć do multimediów witryny. Brakuje uprawnienia „Zarządzaj mediami Stron”. Nie puszczamy takiego połączenia dalej, bo artykuły wychodziłyby bez zdjęć. Edytuj klucz w Menedżerze kluczy API i zaznacz je dodatkowo. Osobna sprawa to wyczerpany limit miejsca na multimedia w Twoim planie Wix: wtedy potrafi nie wejść pojedyncze zdjęcie, ale sam artykuł i tak się opublikuje.
Synchronizacja katalogu jest niedostępna. Albo na stronie nie ma Wix Stores, albo klucz nie ma uprawnień do odczytu produktów i kategorii. Jeśli sklepu nie prowadzisz, tak ma być i nic nie trzeba robić.
Tytuł SEO, opis SEO albo adres wpisu wyglądają inaczej, niż chciałeś. Te trzy pola wysyłamy sami, w „seoData” i „seoSlug”, więc to nie jest ograniczenie Wixa, tylko nasz wybór treści. Napisz nam, co ma być zamiast, a poprawimy to u źródła. Ręczna zmiana w panelu bloga Wix też zadziała, ale zostanie nadpisana przy najbliższej aktualizacji artykułu.
Nie przyszedł kod weryfikacyjny przy generowaniu klucza. Wix wysyła go e-mailem albo SMS-em, zależnie od konta, więc zajrzyj najpierw do skrzynki przypisanej do konta Wix, razem ze spamem. Poza tym to jest po stronie weryfikacji dwuetapowej Wix i my nic tu nie poradzimy; Wix odsyła w takim wypadku do własnego wsparcia.
Publikacja przestała działać po kilku miesiącach. Klucze API Wix nie wygasają same, ale można je usunąć albo wymienić w Menedżerze kluczy API, a wtedy stary przestaje działać z minuty na minutę. Sprawdź, czy klucz nadal tam jest i czy nadal ma tę witrynę na liście.

Skąd to wiemy

Wszystko powyżej pochodzi z dokumentacji Wix i z prawdziwej witryny Wix, a nie z pamięci. Dokumentacja odczytana 23 sierpnia 2026, uprawnienia do członków, pole autora wpisu oraz pola SEO sprawdzone ponownie 18 września 2026. Całe podłączenie, publikacja artykułu ze zdjęciami i nazwy uprawnień w panelu sprawdzone na prawdziwej witrynie Wix 19 września 2026.

Podłącz swój Wix