Go Headless

Build Apps

Client

API Preview

Ricos

Develop Websites

REST

Velo

GraphQL (Alpha)

Gets a code representing the site's currency.

The retrieved currency code corresponds to the currency that has been
 entered in the General Info section of your site's Dashboard.

 The currency is used your site, apps (e.g. Wix Stores, Wix Bookings), and other
 Wix features.

```javascript
import { createClient } from "@wix/sdk"; 
import { site } from "@wix/site";
import { site as wixSite } from "@wix/site-site";

const wixClient = createClient({ 
  host: site.host(), 
  modules: { wixSite }
});

const currency = await wixClient.wixSite.currency(); // "USD"
```

Get the site's currency

currency

string

Gets information about the current page or lightbox.

```javascript
import { createClient } from "@wix/sdk"; 
import { site } from "@wix/site";
import { site as wixSite } from "@wix/site-site";

const wixClient = createClient({ 
  host: site.host(), 
  modules: { wixSite } 
});

// ...

const currentPage = await wixClient.wixSite.currentPage();

/*
 *  {
 *    "name": "Home",
 *    "type": "static",
 *    "url": "/home",
 *    "isHomePage": true
 *  }
 */
```

Get information about the current page

```javascript
import { createClient } from "@wix/sdk"; 
import { site } from "@wix/site";
import { site as wixSite } from "@wix/site-site";

const wixClient = createClient({ 
  host: site.host(), 
  modules: { wixSite }
});

// ...

const currentLightbox = await wixClient.wixSite.currentPage();

/*
 *  {
 *    "name": "Welcome (Full Screen)"
 *    "type": "lightbox"
 *  }
 */
```

Get information about the current lightbox

currentPage

List of fonts to be loaded, where each font is represented by a value of a `font` CSS property.

fonts

The options used when getting the HTML element.

options

getFontsHtmlOptions

Gets an HTML element containing CSS code to load fonts.

Use the `getFontsHtml()` function to get an HTML element containing the CSS code that loads one or more fonts.
Use this function when embedding a custom element in a Wix site where the page's stylesheet fonts
are inaccessible, such as when using a shadow root or an internal iframe.

getFontsHtml

Fulfilled - HTML element containing the CSS code that loads the fonts.

Gets the site display name.

Retrieves the site display name, which is the name that
 has been entered in the **Website Settings** section of the site's [**Dashboard**](https://support.wix.com/en/article/wix-dashboard-overview).

```javascript
import { createClient } from "@wix/sdk"; 
import { site } from "@wix/site";
import { site as wixSite } from "@wix/site-site";

const wixClient = createClient({ 
  host: site.host(), 
  modules: { wixSite } 
});

const siteName = await wixClient.wixSite.getSiteDisplayName(); // "My Site"
```

Get the site display name

getSiteDisplayName

Returns information about the site's pages, prefixes, and lightboxes.

The returned `SiteStructure` object is a flattened representation of the site.
 The structure does not include the headers and links from the site's **Pages** menu.

```javascript
import { createClient } from "@wix/sdk"; 
import { site } from "@wix/site";
import { site as wixSite } from "@wix/site-site";

const wixClient = createClient({ host: site.host(), modules: { wixSite } });

(async () => {
  const structure = await wixClient.wixSite.getSiteStructure();

  /*
  *  {
  *    "pages": [
  *      {
  *        "name": "Home",
  *        "type": "static",
  *        "url": "/home",
  *        "isHomePage": true
  *      },
  *      {
  *        "name": "Page 1",
  *        "type": "static",
  *        "url:" /page-1"
  *      },
  *      {
  *        "name": "Page 2",
  *        "type": "static",
  *        "url": "/page-2"
  *      },
  *      {
  *        "name": "Parent Page",
  *        "type": "static",
  *        "url": "/parent-page"
  *      },
  *      {
  *        "name": "Child Page",
  *        "type": "static",
  *        "url": "/child-page"
  *      },
  *      {
  *        "name": "router-page",
  *        "type": "template",
  *        "prefix": "router"
  *      },
  *      {
  *        "name": "MyCollection (Title)",
  *        "type": "template",
  *        "prefix": "MyCollection"
  *      },
  *      {
  *        "name": "MyCollection (All)",
  *        "type": "template",
  *        "prefix": "MyCollection"
  *      },
  *      {
  *        "name": "Dashboard Page",
  *        "type": "static"
  *      },
  *      {
  *        "name": "Shop",
  *        "type": "template",
  *        "url": "/shop",
  *        "applicationId": "215238eb-22a5-4c36-9e7b-e7c08025e04e"
  *      },
  *      {
  *        "name": "Product Page",
  *        "type": "template",
  *        "url": "/product-page",
  *        "applicationId": "215238eb-22a5-4c36-9e7b-e7c08025e04e"
  *      },
  *      {
  *        "name": "Thank You Page",
  *        "type": "template",
  *        "url": "/thank-you-page",
  *        "applicationId": "215238eb-22a5-4c36-9e7b-e7c08025e04e"
  *      },
  *      {
  *        "name": "Cart",
  *        "type": "template",
  *        "url": "/cart",
  *        "applicationId": "215238eb-22a5-4c36-9e7b-e7c08025e04e"
  *      },
  *      {
  *        "name": "Members",
  *        "type": "template",
  *        "url": "/members",
  *        "applicationId": "14ad9202-3dd3-128a-57bd-e5675fd7e313"
  *      }
  *    ],
  *    "prefixes": [
  *      {
  *        "name": "router",
  *        "type": "router",
  *        "prefix": "/router"
  *      },
  *      {
  *        "name": "MyCollection",
  *        "type": "dynamicPages",
  *        "prefix": "/MyCollection"
  *      },
  *      {
  *        "name": "MyCollection",
  *        "type": "dynamicPages",
  *        "prefix": "/MyCollection"
  *      },
  *      {
  *        "name": "Shop",
  *        "type": "app",
  *        "prefix: "/shop",
  *        "applicationId": "215238eb-22a5-4c36-9e7b-e7c08025e04e"
  *      },
  *      {
  *        "name": "Product Page",
  *        "type": "app",
  *        "prefix": "/product-page",
  *        "applicationId": "215238eb-22a5-4c36-9e7b-e7c08025e04e"
  *      },
  *      {
  *        "name": "Thank You Page",
  *        "type": "app",
  *        "prefix": "/thank-you-page",
  *        "applicationId": "215238eb-22a5-4c36-9e7b-e7c08025e04e"
  *      },
  *      {
  *        "name": "Cart",
  *        "type": "app",
  *        "url": "/cart",
  *        "applicationId": "215238eb-22a5-4c36-9e7b-e7c08025e04e"
  *      },
  *      {
  *        "name": "Members",
  *        "type": "app",
  *        "prefix": "/members",
  *        "applicationId": "14ad9202-3dd3-128a-57bd-e5675fd7e313"
  *      }
  *    ],
  *    "lightboxes": [
  *      {
  *        "name": "Welcome (Full Screen)"
  *      }
  *    ]
  *  }
  */
})();
```

This example gets the structure of the site with the following in its pages menu:
 ![Site Structure](images/site_structure.png "Site Structure")

Get information about the site's pages, prefixes, and lightboxes

getSiteStructure

SiteStructure

An object that contains information about the site's pages, prefixes, and lightboxes.

getSiteThemeHtmlOptions

Gets the CSS code of the site's theme.
Use the `getSiteThemeHtml()` function to get an HTML element containing the CSS code of a site's
[theme colors and fonts](https://support.wix.com/en/article/wix-editor-customizing-your-sites-theme-and-design).
Use this function when embedding a custom element in a Wix site where the page's stylesheet
is inaccessible, such as when using a shadow root or an internal iframe.

getSiteThemeHtml

Fulfilled - HTML element containing site's theme CSS.

Gets a code representing the site's language.

The retrieved language code corresponds to the main site language
 as found in the General Info section of your site's Dashboard.

 > **Note:** If you have a multilingual site, and it is being viewed in a language
 that is not the main site language, the `language` property still returns
 the main site language. To work with the languages of a multilingual site,
 use the [Multilingual API](https://dev.wix.com/docs/velo/api-reference/wix-window-frontend/multilingual/introduction).

```javascript
import { createClient } from "@wix/sdk"; 
import { site } from "@wix/site";
import { site as wixSite } from "@wix/site-site";

const wixClient = createClient({ 
  host: site.host(), 
  modules: { wixSite } 
});

const language = await wixClient.wixSite.language(); // "en"
```

Get the site's language

language

The items within the site to prefetch resources for.

prefetchItems

PrefetchItems

Optimizes resource fetching of pages and lightboxes in the site so they will load faster.

Use the `prefetchPageResources()` function to optimize resource fetching of pages and
 lightboxes you think your site visitors are likely to visit next. When the site
 visitor navigates to those pages or lightboxes, they will load quicker than usual
 since some of their resources have already been retrieved.

 You can only prefetch resources from pages or lightboxes within the current site.

 A prefetch is considered successful if the specified pages and lightboxes exist in
 the current site. If any of the specified pages or lightboxes do not exist, the
 prefetch operation returns an error status and lists of the pages and lightboxes
 that were not found.

```javascript
import { createClient } from "@wix/sdk"; 
import { site } from "@wix/site";
import { site as wixSite } from "@wix/site-site";

const wixClient = createClient({ host: site.host(), modules: { wixSite } });

const response = await wixClient.wixSite.prefetchPageResources({
  "lightboxes": ["First Box", "Second Box"],
  "pages": ["/first-page", "/second-page"]
});

if(response.errors) {
  // handle errors
}

/*
 * response is:
 *
 * {
 *   "message": "success"
 * }
 */
```

Prefetch resources successfully

```javascript
import { createClient } from "@wix/sdk"; 
import { site } from "@wix/site";
import { site as wixSite } from "@wix/site-site";

const wixClient = createClient({ host: site.host(), modules: { wixSite } });

const response = await wixClient.wixSite.prefetchPageResources({
  "lightboxes": ["My Lightbox", "Fake Lightbox"],
  "pages": ["/my-page", "/nonexistent-page"]
});

if(response.errors) {
  // handle errors
}

/*
 * response is:
 *
 * {
 *   "message": "some resources not found",
 *   "errors": {
 *     "lightboxes": ["Fake Lightbox"],
 *     "pages": ["/nonexistent-page"]
 *   }
 * }
 */
```

Prefetch resources unsuccessfully

prefetchPageResources

PrefetchResult

Gets the site's regional settings.

The retrieved regional settings corresponds to the regional settings
 that has been entered in the General Info section of your site's Dashboard.

 The regional settings are used to determine how numbers, dates, and currencies
 are displayed on your site.

```javascript
import { createClient } from "@wix/sdk"; 
import { site } from "@wix/site";
import { site as wixSite } from "@wix/site-site";

const wixClient = createClient({ 
  host: site.host(), 
  modules: { wixSite } 
});

const regionalSettings = await wixClient.wixSite.regionalSettings(); // "en-us"
```

Get the site's regionalSettings

regionalSettings

Gets the site revision ID.

The site revision ID is a unique identifier for the current revision of
 your site. Each time you manually save your site or publish your site
 following a change, a new revision is created.

You can view and manage your site revisions in your [Site History](https://support.wix.com/en/article/viewing-and-managing-your-site-history).
You can use [site monitoring](https://support.wix.com/en/article/about-site-monitoring#site-revisions) to
monitor and debug new revisions of your site.

 > **Notes:**
 > + Since publishing your site may change the revision ID, the ID when
 >   previewing your site may be different than the ID for the published site.
>
>
> + The site revision ID is guaranteed to be unique, but not meaningful.
>   Therefore, you cannot predict future revision IDs before they are created.

```javascript
import { createClient } from "@wix/sdk"; 
import { site } from "@wix/site";
import { site as wixSite } from "@wix/site-site";

const wixClient = createClient({ 
  host: site.host(), 
  modules: { wixSite } 
});

// ...

const revision = await wixClient.wixSite.revision(); // "4x2y"
```

Get the site revision ID

revision

The prefix of the router to get the sitemap for.

routerPrefix

Returns the sitemap for a router or dynamic page prefix.

The `routerSitemap()` function returns a Promise that resolves to a list of
 [`WixSitemapEntry`](https://dev.wix.com/docs/velo/api-reference/wix-router/wix-router-sitemap-entry) objects. Each
 [`WixSitemapEntry`](https://dev.wix.com/docs/velo/api-reference/wix-router/wix-router-sitemap-entry) includes
 information about a page, such as its URL, title, and name.

 A sitemap is used by search engines to find the links to the site's pages.

```javascript
import { createClient } from "@wix/sdk"; 
import { site } from "@wix/site";
import { site as wixSite } from "@wix/site-site";

const wixClient = createClient({ 
  host: site.host(), 
  modules: { wixSite } 
});

// ...

(async () => {
  const routerSitemap = await wixClient.wixSite.routerSitemap("routerPrefix");
  const sitemap = routerSitemap;

  /*
   * sitemap:
   *
   * [
   *   {
   *   	"url": "Ash",
   *   	"lastModified": null,
   *   	"changeFrequency": "",
   *   	"priority": null,
   *   	"title": "Ash Stowe",
   *   	"pageName": "Ash's Page"
   *   },
   *   {
   *   	"url": "Aiden",
   *   	"lastModified": null,
   *   	"changeFrequency": "",
   *   	"priority": null,
   *   	"title": "Aiden Johnson",
   *   	"pageName": "Aiden's page"
   *   },
   *   {
   *   	"url": "Jess",
   *   	"lastModified": null,
   *   	"changeFrequency": "",
   *   	"priority": null,
   *   	"title": "Jess White",
   *   	"pageName": "Jess's page"
   *   },
   *   {
   *   	"url": "Morgan",
   *   	"lastModified": null,
   *   	"changeFrequency": "",
   *   	"priority": null,
   *   	"title": "Morgan James",
   *   	"pageName": "Morgan's Page"
   *   }
   * ]
   */
})();
```

Get the sitemap for a prefix

routerSitemap

WixRouterSitemapEntry

Fulfilled - A list of sitemap entries.
Rejected - The error that caused the rejection.

Gets the site's timezone.

The retrieved timezone is the timezone that has been
 entered in the General Info section of your site's Dashboard.

 The timezone is used your site, apps (e.g. Wix Stores, Wix Bookings), and other
 Wix features.

```javascript
import { createClient } from "@wix/sdk"; 
import { site } from "@wix/site";
import { site as wixSite } from "@wix/site-site";

// ...

const wixClient = createClient({ 
  host: site.host(), 
  modules: { wixSite } 
});

const timezone = await wixClient.wixSite.timezone(); // "America/New_York"
```

Get the site's timezone

timezone

# Introduction
To use the site module, import `wixSiteFrontend` from the `@wix/site-site` module:

   ```javascript
   import wixSiteFrontend from '@wix/site-site';
   ```

 The APIs in `@wix/site-site` can only be used in front-end code.

site-site

Gets how frequently the page is likely to change.

The value of the `changeFrequency` property provides general information to
search engines and may not correlate exactly to how often they crawl the page.

Valid values:

+ `"always"`
+ `"hourly"`
+ `"daily"`
+ `"weekly"`
+ `"monthly"`
+ `"yearly"`
+ `"never"`

changeFrequency

Gets when the page data was last modified.

lastModified

pageName

Gets the priority of this URL relative to other URLs on your site.

The value of the `priority` property lets search engines know which pages
you deem most important. Its value does not affect how your pages are
compared to pages on other sites.

Valid values range from 0.0 to 1.0.

The default priority of a page is 0.5.

priority

title

The names of the lightboxes in your site to prefetch
 resources for.

 > **Note:** Pages are listed by relative or absolute URL, but lightboxes are listed by name.
 See [`location.to()`](location.html#to) to learn how to find a page's relative
 URL. You can find a lightbox's name by selecting the lightbox and clicking the settings button.

lightboxes

The relative or absolute URLs of the pages in your site
 to prefetch resources for.

pages

errors

PrefetchResultError

message

The names of the lightbox for which prefetch failed.

The names of the pages for which prefetch failed.

Prefix

If the prefix is an app's prefix, the `applicationId` property is the app's ID.

applicationId

name

prefix

The type of the prefix.

 A site's routers, dynamic pages, and app pages all have prefixes.

 One of:

 + `"dynamicPages"`
 + `"router"`
 + `"app"`

type

The pages of the site.
 Pages can be regular pages, dynamic pages, router pages, or pages from an app.

The prefixes of the site's routers and dynamic pages.

prefixes

StructureLightbox

StructurePage

If the page is an app page, the `applicationId` property is the app's ID.

If the page is the Home page, `isHomePage` is `true`. Otherwise, it does not exist.

isHomePage

boolean

If the page is a router or dynamic page, the `prefix` property is the page's prefix.

The type of the page: `"static"` or `"template"`.

The URL of the page. If the page is a `static` page the `url` property is the page's SEO URL.

number

An identifier that is added in a `data-test-id` attribute on the returned HTML element. Use this identifier to locate the HTML element when testing your code.

testId

An identifier that is added in a `data-test-id` attribute on the returned HTML element. You can use this identifier to locate the HTML element when testing your code.

lastModified( )