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

# Import i eksport quizów

> Jak importować quizy z plików i eksportować do ponownego użycia

## Przegląd

Hey Quiz obsługuje import i eksport quizów w formatach:

* **JSON** - pełna struktura quizu
* **Excel (XLSX)** - arkusz kalkulacyjny

## Import quizu

### Z pliku JSON

<Steps>
  <Step title="Przejdź do importu">
    W panelu **Moje quizy** kliknij **"Importuj"**.
  </Step>

  <Step title="Wybierz plik JSON">
    Kliknij **"Wybierz plik"** i wskaż plik `.json`.
  </Step>

  <Step title="Przejrzyj podgląd">
    System wyświetli podgląd quizu:

    * Tytuł
    * Liczba pytań
    * Typy pytań
  </Step>

  <Step title="Importuj">
    Kliknij **"Importuj"** - quiz pojawi się na liście.
  </Step>
</Steps>

### Z pliku Excel

<Steps>
  <Step title="Przygotuj plik Excel">
    Struktura arkusza:

    | Kolumna | Zawartość                                          |
    | ------- | -------------------------------------------------- |
    | A       | Treść pytania                                      |
    | B       | Typ pytania (single/multiple/true\_false/ordering) |
    | C       | Odpowiedź 1                                        |
    | D       | Odpowiedź 2                                        |
    | E       | Odpowiedź 3                                        |
    | F       | Odpowiedź 4                                        |
    | G       | Poprawne odpowiedzi (np. "1" lub "1,3")            |
    | H       | Czas (sekundy)                                     |
    | I       | Punkty                                             |
  </Step>

  <Step title="Importuj plik">
    Wybierz plik `.xlsx` w oknie importu.
  </Step>

  <Step title="Mapuj kolumny">
    Jeśli struktura jest inna, zmapuj kolumny do odpowiednich pól.
  </Step>

  <Step title="Przejrzyj i zaimportuj">
    Sprawdź podgląd i kliknij **"Importuj"**.
  </Step>
</Steps>

<Info>
  **Szablon Excel**: Pobierz [szablon Excel](/files/quiz-template.xlsx) z przykładowymi danymi.
</Info>

### Obsługiwane typy pytań przy imporcie

| Typ w pliku  | Typ w Hey Quiz    |
| ------------ | ----------------- |
| `single`     | Jednokrotny wybór |
| `multiple`   | Wielokrotny wybór |
| `true_false` | Prawda/Fałsz      |
| `ordering`   | Uporządkuj        |

<Warning>
  Typy **Zgłoś się**, **Ankieta**, **Uzupełnij lukę**, **Dopasuj** i **Pytanie otwarte** nie są obecnie obsługiwane przy imporcie. Dodaj je ręcznie po imporcie.
</Warning>

## Eksport quizu

### Do JSON

<Steps>
  <Step title="Znajdź quiz">
    W panelu **Moje quizy** znajdź quiz do eksportu.
  </Step>

  <Step title="Kliknij Eksport">
    Kliknij przycisk **"Eksport"** przy quizie.
  </Step>

  <Step title="Wybierz format">
    Wybierz **JSON** z listy formatów.
  </Step>

  <Step title="Pobierz plik">
    Plik zostanie pobrany automatycznie.
  </Step>
</Steps>

### Do Excel

Analogicznie jak JSON, ale wybierz format **Excel (XLSX)**.

## Struktura pliku JSON

```json theme={null}
{
  "title": "Nazwa quizu",
  "description": "Opis quizu",
  "language": "pl",
  "questions": [
    {
      "type": "single",
      "content": "Treść pytania?",
      "time_limit": 20,
      "points": 1000,
      "answers": [
        {"content": "Odpowiedź A", "is_correct": false},
        {"content": "Odpowiedź B", "is_correct": true},
        {"content": "Odpowiedź C", "is_correct": false}
      ],
      "explanation": "Wyjaśnienie (opcjonalne)"
    }
  ]
}
```

## Przypadki użycia

### Backup quizów

Regularnie eksportuj ważne quizy do JSON jako kopię zapasową.

### Współdzielenie z innymi

Wyeksportuj quiz i wyślij plik koledze - może go zaimportować na swoje konto.

### Przenoszenie między kontami

Eksport z jednego konta → Import na drugie.

### Tworzenie wariantów

1. Eksportuj quiz
2. Edytuj plik JSON
3. Zmień tytuł i pytania
4. Importuj jako nowy quiz

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="Import nie działa">
    * Sprawdź format pliku (JSON/XLSX)
    * Upewnij się, że struktura jest poprawna
    * Sprawdź kodowanie znaków (UTF-8)
  </Accordion>

  <Accordion title="Brakuje niektórych pytań">
    * Pytania z błędną strukturą są pomijane
    * Sprawdź czy wszystkie wymagane pola są wypełnione
  </Accordion>

  <Accordion title="Polskie znaki są zniekształcone">
    * Plik musi być zapisany w kodowaniu UTF-8
    * W Excel: Zapisz jako → Wybierz UTF-8
  </Accordion>
</AccordionGroup>

## Następne kroki

<CardGroup cols={2}>
  <Card title="Klonowanie quizu" icon="copy" href="/pl/quizy/klonowanie">
    Szybkie duplikowanie
  </Card>

  <Card title="Generator AI" icon="robot" href="/pl/ai/generator">
    Automatyczne tworzenie quizów
  </Card>
</CardGroup>