Slides for Developers

We strive to make Slides a great and flexible tool for developers. Presentations created on Slides are HTML documents under the hood, so generally anything that HTML can do, Slides can do. We make it easy to access and edit the underlying HTML and CSS through the Developer Mode.

There's also an API for creating new presentations with preset content and we're aiming to add additional APIs in the future.

Developer Mode

The Slides editor has a developer mode which is useful if you know a bit of HTML and CSS. With this mode active you will be able to modify the underlying HTML of your deck, allowing you to make adjustments that the Slides editor does not provide interface options for.

To enable the developer mode open the editor settings in the bottom left corner:

Editing HTML

The per-slide HTML editor can be accessed from the slide options area. It gives you raw access to the current slide's HTML, allowing you to change anything you like. Note that some elements, such as <script> and <link>, are not allowed for security reasons.

Element Classes (Requires Pro)

As a paying Slides customer you have access to the CSS editor which allows you to add custom styles to your deck. By turning on the developer mode a new "class name" field will appear for any block that you focus. This allows you to easily target a specific element with your CSS.

Here's an example that defines an "upside-down" class using custom CSS and applies it to a text block.

.upside-down {
    transform: scale( 1, -1 );
}

Slide Classes (Requires Pro)

Just like you can add custom classes to individual elements it's also possible to add custom classes at the slide level. This can used to apply broader changes to the whole slide like inverting text and icon colors or changing the slide transition.

Under the hood the slide background element is separate from the slide itself. Here are two examples showing how you'd target the slide contents or slide background using a custom class called "night-sky":

// Targets the slide contents
.slides .night-sky svg path {
    fill: yellow;
}

// Target the slide background
.backgrounds .night-sky {
    background: linear-gradient(0deg, #141528, #0b1bb2);
}

Export HTML

You can access the complete HTML for all slides in your deck inside of the export panel, under "Export to reveal.js". This provides a way of exporting your deck markup and the core Slides styles to reveal.js. There are a few limitations with exporting this way but it should provide a good starting point.

CSS Editor (Requires Pro)

The CSS editor lets you author custom styles for your presentation with a real-time preview of the result. It's available as an option inside of the Style panel of the presentation editor.

The editor preprocesses styles using LESS, though you're free to write plain CSS as well. We apply the styles in real-time as you type so there's no need to leave the editor or even press a refresh button to see what you're getting. Note that when your styles are saved they will be automatically wrapped in a ".reveal {}" selector to avoid conflicts with other page styles.

Custom Fonts

You can load custom fonts from Typekit and Google fonts and apply them using custom CSS. Find out more.

Developer Mode

If you turn on the developer mode you can also add custom classes to any focused element. This is a convenient way to easily apply your CSS to specific elements.

Examples

// Change presentation progress bar color
.progress span {
    background: #ff0000;
}

// Change control arrow color
.controls button {
    color: #ff0000;
}

// Change presentation background
& {
    background: #a83239;
}

// Change color of body text
.slides {
    color: #009999;
}

// Turn text white if the slide has a dark background
.has-dark-background {
    color: #ffffff;
}

// Add a blue border to all slides (each slide is a <section>)
.slides section {
    outline: 1px solid blue;
}

// Add a red border to all vertical stacks of slides
.slides section.stack {
    outline: 1px solid red;
}
// Include a custom font
@font-face {
  font-family: "Cabin Sketch";
  src: url("https://s3.amazonaws.com/static.slid.es/fonts/cabinsketch/cabinsketch-regular.woff") format("woff"),
       url("https://s3.amazonaws.com/static.slid.es/fonts/cabinsketch/cabinsketch-regular.ttf") format("truetype");
}
.slides h1, .slides h2, .slides h3 {
    font-family: "Cabin Sketch";
}

Here's where you can access the CSS editor from inside of the Style panel:

A screenshot of the editor:



Define API: Create Prefilled Decks (beta)

The define API lets you create a presentation programatically and add it to the current user's Slides account. Presentations you create can include any of the content types that the Slides editor supports. You can even include live data from other sites via iframes.

For example, if you operate a web-based charting service, you can let your users create a presentation containing their fully interactive charts at the click of a button.

If the user isn't already signed in to Slides, they will automatically be prompted to authenticate or sign up. Once signed in, they are able to review the deck and confirm that they want to save it to their account. Here's what that process looks like:

The Request

To start the process you'll need to have the user submit an HTML form towards the http://slides.com/decks/define endpoint. The form needs to contain an input field with the name definition and the value of this input should be the JSON representation of a deck. Once the form is submitted, we'll automatically redirect the user to the appropriate page.

Request Method POST
Request URL https://slides.com/decks/define
Request Payload definition: DECK_JSON_HERE

Here's a fully working example:

Deck JSON Examples

Here's the bare minimum JSON you'll need to describe a deck.

{
	  "title": "My Deck",
	  "slides": [
	    { "html": "<h1>Slide 1</h1>" },
	    { "html": "<h1>Slide 2</h1>" }
	  ]
	}

If you want to group multiple slides into one vertical stack you can nest them in an array:

{
	  "title": "My Deck",
	  "slides": [
	    { "markdown": "# Slide 1" },
	    [
	        { "markdown": "# Vertical Slide 2.1" },
	        { "markdown": "# Vertical Slide 2.2" }
	    ],
	    { "markdown": "# Slide 3" }
	  ]
	}

The following JSON demonstrates most of the available options.

Note that there are three different ways to define slide content, blocks, HTML and Markdown. The benefit of using content blocks is that the elements you define are separately editable inside of the Slides editor. If you specify content as a string of HTML or Markdown, it will all be grouped into one element and edited as a text box.

{
  "title": "My Deck",
  "description": "Description of My Deck.",
  "width": 1024,
  "height": 576,
  "auto-slide-interval": 0,
  "slide-number": false,
  "loop": false,
  "theme-color": "white",
  "theme-font": "overpass",
  "transition": "slide",
  "slides": [
    {
      "background-color": "#cccccc",
      "background-image": "https://s3.amazonaws.com/static.slid.es/images/screenshots/v1/slides-homepage-1440x900.png",
      "background-size": "cover",
      "notes": "My speaker notes",
      "blocks": [
        {
          "type": "text",
          "value": "Hello world!",
          "format": "h2"
        },
        {
          "type": "image",
          "value": "https://s3.amazonaws.com/static.slid.es/images/screenshots/v1/slides-homepage-1440x900.png"
        },
        {
          "type": "iframe",
          "value": "https://slides.com/news/make-better-presentations/embed"
        }
      ]
    },
    {
      "background-image": "https://s3.amazonaws.com/static.slid.es/images/screenshots/v1/slides-homepage-1440x900.png"
    },
    {
      "html": "<h1>HTML Slide</h1>"
    },
    {
      "markdown": "**Markdown** slide! <https://daringfireball.net/projects/markdown/syntax>"
    }
  ]
}

Deck JSON Spec

Property Description
title
String
The title of the presentation. Appears anywhere the deck is listed on slides.com.
description
String Optional
A short description of the presentation. Appears anywhere the deck is listed on slides.com.
width
Integer
The presentation width in pixels. Defaults to 960. We automatically scale content up or down to fit any display.
height
Integer
The presentation height in pixels. Defaults to 700. We automatically scale content up or down to fit any display.
auto-slide-interval
Integer Optional
Optionally make the presentation auto-slide. This value is defined in milliseconds and defaults to 0 (no autosliding).
slide-number
Boolean Optional
Flags if a slide number should show the current slide number when viewing the presentations. False by default.
loop
Boolean Optional
Flags if the last slide of the presentation should loop back to the first. False by default.
theme-color
String Optional
Presentation color. Available options:
Value Description
white-blue White background, black text, blue links (default).
black-blue Black background, white text, blue links.
theme-font
String Optional
Presentation fonts. Open the Slides editor "Style" panel for previews. Available options:
Value Font style
montserrat sans-serif (default)
asul semi-serif
helvetica sans-serif
josefine sans-serif
league sans-serif
merriweather sans-serif
news sans-serif
opensans sans-serif
overpass sans-serif
palatino serif
quicksand sans-serif
sketch Sans-serif
transition
String Optional
The transition to use when moving between slides.
Value Description
slide Slide between slides (default).
none No transition at all.
fade Fade slides in and out.
concave Slide between slides with a concave 3D effect.
convex Slide between slides with a convex 3D effect.
slides
Array
Each record in this array represents a slide. You can group multiple slides in a nested array to create vertical stacks, like this:
[ "slide 1", ["slide 2.1", " slide 2.2" ], "slide 3" ]
slides.background-color
String Optional
Slide background color. Supports all CSS color formats, like red or #ff0000.
slides.background-image
String Optional
URL to a background image. Supported formats: JPG, PNG, GIF and SVG.
slides.background-size
String Optional
Controls the sizing of a background image. Options:
Value Description
cover Covers the full page regardless of aspect ratio by allowing cropping (default).
contain As large as possible without cropping.
slides.notes
String Optional
Plain text speaker notes that will appear when presenting this deck. Maximum length is 10000 characters.
slides.html
String Optional
Custom HTML that should be added to the slide. The HTML will be placed into a content block and centered on the slide. Note that we strip out all scripts, style tags and external stylesheets.
slides.markdown
String Optional
Markdown content that should be added to the slide. The HTML output will be placed in a content block and centered on the slide.
slides.blocks
Array Optional
An array of content blocks. Blocks are automatically placed in a column at the center of the page.
slides.blocks.type
String
The type of content you want to insert.
Value Description
text Multiline text block. More info
image JPG, PNG, GIF or SVG image. More info
iframe Embedded web page. More info
code Syntax highlighted code. More info
slides.blocks.x
Integer Optional
The horizontal position of the block in pixels. If this value is not defined, we will automatically place it at the center of the slide.
slides.blocks.y
Integer Optional
The vertical position of the block in pixels. If this value is not defined, we will automatically place it at the center of the slide.
slides.blocks.width
Integer Optional
The width of the content block in pixels.
slides.blocks.height
Integer Optional
The height of the content block in pixels. Note that some blocks, like text, ignore this value since height is based on how tall the content is.

Text block

Properties available for the text content block.

Property Description
slides.blocks.value
String
The string of text to insert.
slides.blocks.format
String Optional
The text format, defined as one of the following HTML tags:
Value Description
h1 Heading 1
h2 Heading 2
h3 Heading 3
p Paragraph
pre Preformatted text

If no format is specified, we pick a good default based on what other blocks there are on the slide. For example, if you have two text blocks we'll use an h1 for the first block and h2 for the second.

slides.blocks.align
String Optional
Left, center, right or justify.
slides.blocks.padding
Integer Optional
The number of pixels to leave empty around the text.

Image block

Properties available for the image content block.

Property Description
slides.blocks.value
String
The URL of the image to insert. We support JPG, PNG, GIF and SVG.

Iframe block

Properties available for the iframe content block.

Property Description
slides.blocks.value
String
The HTTPS URL of the web page to embed.

Code block

Properties available for the code content block.

Property Description
slides.blocks.value
String
Code to syntax highlight.
slides.blocks.language
String
The language of the code. We use highlight.js for syntax highlighting, you can see which languages they support at highlightjs.org/static/demo.

If no language is specified, highlight.js will automatically try to determine what language it is.
slides.blocks.theme
String
The theme to use for syntax highlighting. We support the following themes:
Value Description
zenburn Zenburn (default)
ascetic Ascetic
far Far
github-gist GitHub Gist
ir-black Ir Black
monokai Monokai
obsidian Obsidian
solarized-dark Solarized Dark
solarized-light Solarized Light
tomorrow Tomorrow
xcode Xcode