Themes

Retrieve theme

get
https://api.typeform.com/themes/{theme_id}

Retrieves a theme in your Typeform account.

Request

Path Parameters

theme_id
string, required

Unique ID for the theme.

Response

Status

200 OK

Schema

background Path 3
object

Settings for the background.

brightness
number

Brightness for the background. -1 is least bright (minimum) and 1 is most bright (maximum).

href
string

Background image URL.

layout
string
Valid values:fullscreenrepeatno-repeat
Default:fullscreen

Layout for the background.

colors Path 3
object

Colors the theme will apply to answers, background, buttons, and questions.

answer
string

Color the theme will apply to answers. Hexadecimal value.

background
string

Color the theme will apply to background. Hexadecimal value.

button
string

Color the theme will apply to buttons. Hexadecimal value.

question
string

Color the theme will apply to questions. Hexadecimal value.

fields Path 3
object

Defines font size and alignment for fields.

alignment
string
Valid values:leftcenter
Default:left

Fields alignment

font_size
string
Valid values:smallmediumlarge
Default:medium

Fields font size

font
string
Valid values:AcmeArialArvoAvenir NextBangersCabinCabin CondensedCourierCrete RoundDancing ScriptExoGeorgiaHandleeHelvetica NeueKarlaLatoLektonLobsterLoraMcLarenMontserratNixie OneOld Standard TTOpen SansOswaldPlayfair DisplayQuicksandRalewaySignikaSnigletSource Sans ProVollkorn
Default:Source Sans Pro

Font for the theme.

has_transparent_button
boolean

true if buttons should be transparent. Otherwise, false.

id
string

Unique ID of the theme.

name
string

Name of the theme.

rounded_corners
string
Valid values:nonesmalllarge
Default:small

Specifies border radius style of buttons and other elements in the form.

screens Path 3
object

Defines font size and alignment for welcome and thankyou screens.

alignment
string
Valid values:leftcenter
Default:center

Screen alignment

font_size
string
Valid values:smallmediumlarge
Default:small

Screen font size

visibility
string
Valid values:publicprivate
Default:private

Specifies whether the theme is public (one of Typeform's built-in themes that are available in all accounts) or private (a theme you created). You can only change private themes. You can't change Typeform's public themes.

Example

{
  "background": {
    "brightness": -0.59,
    "image_id": 987,
    "layout": "fullscreen"
  },
  "colors": {
    "answer": "#800000",
    "background": "#FFFFFF",
    "button": "#808080",
    "question": "#000000"
  },
  "fields": {
    "alignment": "left",
    "font_size": "medium"
  },
  "font": "Arial",
  "has_transparent_button": false,
  "id": 456,
  "name": "My theme",
  "rounded_corners": "small",
  "screens": {
    "alignment": "center",
    "font_size": "small"
  },
  "visibility": "private"
}