---
title: "Imports"
description: "Bring in PowerPoint and Impress presentations, GIFT and CSV questions, XLIFF translations, course scripts and project files."
canonical_url: "https://docs.ols.yonn.online/en/ship/imports"
---
# Imports

> Bring in PowerPoint and Impress presentations, GIFT and CSV questions, XLIFF translations, course scripts and project files.

You don't have to start from scratch. The Studio takes over material you already have: slides from presentations, questions from Moodle or a spreadsheet, translations from a translation agency, and courses saved as files. Before anything changes, you always see a preview.

What you can import:

- **Presentations** from PowerPoint (`.pptx`) and Impress (`.odp`): as a new course or as extra slides.
- **Questions** from Moodle (GIFT format) or a spreadsheet (CSV).
- **Translations** as XLIFF, the exchange format of translation agencies and tools.
- **Course files**: `.olsx`, `.json`, course scripts and workbench backups.

<hint-box kind="privacy" title="Imported files are checked">

Every imported file is checked, size-limited and cleaned. JavaScript triggers are always switched off after an import.

</hint-box>

## Import a presentation in 4 steps

<procedure>

### Open the import

For a **new course**, drag the `.pptx` or `.odp` file onto the page **My courses**. To **add slides** to an open course, click <ui-path path="Slides > Import presentation">



</ui-path>

. They will go after the current slide.

### Choose the file

Drag the file into the window or click **Choose file**. Nothing is saved before you confirm the preview.

### Pick the slides

The preview shows every slide with its notes. Choose **All**, **None** or single slides. If the presentation has sections, **Scenes from sections** turns each section into its own scene (a chapter in the course menu).

### Read the report and confirm

**Not taken over or simplified** lists per slide what changed. Click **Create course** or **Insert slides**. Inserted slides can be undone with <key-combo keys="Ctrl+Z">



</key-combo>

.

</procedure>

<table>
<thead>
  <tr>
    <th>
      Taken over
    </th>
    
    <th>
      Not taken over or simplified
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Text with font, size, color, bold and italic, bullets and numbering, links
    </td>
    
    <td>
      Charts, SmartArt, 3D objects and embedded objects (you get a labeled placeholder)
    </td>
  </tr>
  
  <tr>
    <td>
      Shapes such as rectangle, circle, arrows, star, speech bubble with fill, line and shadow
    </td>
    
    <td>
      Exit, emphasis and motion path animations; click animations play automatically one after another
    </td>
  </tr>
  
  <tr>
    <td>
      Images with cropping, embedded videos and audio, tables and groups
    </td>
    
    <td>
      Freeforms, arrowheads, hatching, radial gradients, 3D effects, glow and reflections
    </td>
  </tr>
  
  <tr>
    <td>
      Backgrounds, slide masters with layouts, notes, hidden slides
    </td>
    
    <td>
      Linked (not embedded) images and media as well as macros
    </td>
  </tr>
  
  <tr>
    <td>
      Links to other slides and web pages (as click triggers)
    </td>
    
    <td>
      
    </td>
  </tr>
  
  <tr>
    <td>
      Simple entrance animations and slide transitions
    </td>
    
    <td>
      
    </td>
  </tr>
</tbody>
</table>

A new course takes the colors and fonts of the presentation as its design. When you insert slides into a course, your course design stays and the slides keep their colors.

<hint-box kind="tip" title="Keynote files">

The Studio cannot read Keynote files directly. Open the presentation in Keynote, choose *File > Export To > PowerPoint* and import the `.pptx` file.

</hint-box>

## Import questions in 4 steps

![The Import questions window with GIFT text on the left and the preview of eight recognized questions on the right](https://docs.ols.yonn.online/screenshots/en/imports-questions.png)

<procedure>

### Open the window

Click <ui-path path="Slides > Import">



</ui-path>

. The window **Import questions** opens.

### Choose the format

Choose **Moodle GIFT** or **CSV / spreadsheet** at the top left.

### Paste text or choose a file

Paste the text into the box, or click **Choose file** (up to 2 MB). Want to try it first? **Insert example** fills in a sample. On the right, under **Preview**, every recognized question appears with its line number. Untick questions you don't want.

### Choose the target and import

At the bottom, choose **As slides after the current slide** or **Into a question bank**, then click **Import ... questions**.

</procedure>

<table>
<thead>
  <tr>
    <th>
      Element
    </th>
    
    <th>
      What it does
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Moodle GIFT
      </strong>
      
       / <strong>
        CSV / spreadsheet
      </strong>
    </td>
    
    <td>
      The format of your questions.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Choose file
      </strong>
    </td>
    
    <td>
      Loads a file instead of pasted text.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        GIFT example
      </strong>
      
       / <strong>
        CSV template
      </strong>
    </td>
    
    <td>
      Downloads a sample file you can fill in.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Insert example
      </strong>
    </td>
    
    <td>
      Puts a sample into the box so you see how it works.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Preview
      </strong>
    </td>
    
    <td>
      Every recognized question with its type and line number. Errors are listed per line.
    </td>
  </tr>
  
  <tr>
    <td>
      Target
    </td>
    
    <td>
      <strong>
        As slides after the current slide
      </strong>
      
      : each question becomes its own slide. <strong>
        Into a question bank
      </strong>
      
      : the questions go into a bank (new or existing), from which a results slide can draw.
    </td>
  </tr>
</tbody>
</table>

**The GIFT format** is Moodle's text format: one question per paragraph, answers in curly braces. `=` marks correct answers, `~` wrong ones, `#` starts feedback. Example:

```text
::Exit::Where do you go when the alarm sounds? {=To the nearest marked exit ~To the elevator ~Back to your desk}
```

GIFT supports multiple choice, true/false `{T}`, numbers `{#42}` or `{#40..45}`, short answers, matching `{=term -> partner}`, essays `{}`, descriptions and `$CATEGORY:` lines. You can export questions from the Moodle question bank in this format.

**The CSV format** is a spreadsheet: one row per question with a header row, separated by `;`, `,` or tab. Columns: type, question, answers (separated by `|`), correct (number of the correct answer, for example `2` or `1|3`), feedback correct, feedback incorrect, points, title. Types: `mc`, `mr`, `tf`, `short`, `numeric`, `matching`, `essay`, `description`. Tip: start from the **CSV template**.

## Translate a course with XLIFF

**XLIFF** is the file format translation agencies and tools work with. You export all texts, have them translated and import the result back.

<procedure>

### Export the texts

Click <ui-path path="View > Translate">



</ui-path>

. Under **1. Export texts**, choose the **Source language** and **Target language** (any language code, for example `sv` or `pt-BR`) and click **Download XLIFF**.

### Have it translated

Send the file to your translation agency or open it in your translation tool. Every text has a fixed ID, so the translation lands in the right place even if you change the course in the meantime.

### Import the translation

Under **2. Import translation**, click **Choose XLIFF file**. The preview shows changes, unchanged texts, texts without translation, changed source texts and entries not found.

### Apply it

Choose **Create as new course** (recommended: the original stays unchanged) or **Replace in this course** (can be undone). Optionally tick **Set course language to ...** and click **Create copy** or **Apply translation**.

</procedure>

The file contains slide titles, notes, texts and labels, alternative texts, states, questions with answers and feedback, player labels, glossary and resources. XLIFF files can be up to 20 MB.

## Open course files

On **My courses**, drop a file onto the page or click **Open file**.

<table>
<thead>
  <tr>
    <th>
      File
    </th>
    
    <th>
      What it is
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        .olsx
      </code>
    </td>
    
    <td>
      One course with all its media, the Studio's archive format.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        .json
      </code>
    </td>
    
    <td>
      A project file without media.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        .olscript.json
      </code>
    </td>
    
    <td>
      A <a href="https://docs.ols.yonn.online/en/ai/course-script">
        course script
      </a>
      
      , the text format for AI apps.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        .pptx
      </code>
      
      , <code>
        .odp
      </code>
    </td>
    
    <td>
      A presentation that becomes a new course (see above).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        .olsw
      </code>
    </td>
    
    <td>
      A workbench backup with many courses. Restore it via <ui-path path="Workbench > Restore backup">
        
      </ui-path>
      
       (see <a href="https://docs.ols.yonn.online/en/ship/versions-and-backup">
        Versions and backup
      </a>
      
      ).
    </td>
  </tr>
</tbody>
</table>

## If something doesn't work

- **"This file cannot be imported"**: check the file type. Keynote files must be exported as `.pptx` first; flat `.fodp` files must be saved as `.odp`.
- **A question is missing in the preview**: look at the error list for its line number. In GIFT, a blank line must separate questions.
- **"File too large"**: question files can be at most 2 MB, XLIFF files 20 MB. Split the file.
- **A translation does not appear everywhere**: entries listed as "not found" belong to content that was deleted, or the file comes from another course.
- **JavaScript triggers stopped working after an import**: that is on purpose. Turn on **Allow JavaScript** again in <ui-path path="View > Course">



</ui-path>

 if you trust the code.


## Sitemap

See the full [sitemap](https://docs.ols.yonn.online/sitemap.md) for all pages.