[{"data":1,"prerenderedAt":633},["ShallowReactive",2],{"navigation":3,"\u002Funderstanding-cirrus-reader-studio\u002Fkey-concepts":105,"\u002Funderstanding-cirrus-reader-studio\u002Fkey-concepts-surround":630},[4,8,26,39,84],{"title":5,"path":6,"stem":7},"About this manual","\u002Fabout-this-manual","01.about-this-manual",{"title":9,"icon":10,"path":11,"stem":12,"children":13,"page":10},"Part 1: Understanding Cirrus Reader Studio",false,"\u002Funderstanding-cirrus-reader-studio","02.understanding-cirrus-reader-studio",[14,18,22],{"title":15,"path":16,"stem":17},"1. What Cirrus Reader Studio does","\u002Funderstanding-cirrus-reader-studio\u002Fwhat-cirrus-reader-studio-does","02.understanding-cirrus-reader-studio\u002F01.what-cirrus-reader-studio-does",{"title":19,"path":20,"stem":21},"2. Key concepts","\u002Funderstanding-cirrus-reader-studio\u002Fkey-concepts","02.understanding-cirrus-reader-studio\u002F02.key-concepts",{"title":23,"path":24,"stem":25},"3. Finding your way around","\u002Funderstanding-cirrus-reader-studio\u002Ffinding-your-way-around","02.understanding-cirrus-reader-studio\u002F03.finding-your-way-around",{"title":27,"icon":10,"path":28,"stem":29,"children":30,"page":10},"Part 2: Getting started","\u002Fgetting-started","03.getting-started",[31,35],{"title":32,"path":33,"stem":34},"4. Signing in and setting up","\u002Fgetting-started\u002Fsigning-in-and-setting-up","03.getting-started\u002F01.signing-in-and-setting-up",{"title":36,"path":37,"stem":38},"5. Quick start: your first publication on your website","\u002Fgetting-started\u002Fquick-start-your-first-publication-on-your-website","03.getting-started\u002F02.quick-start-your-first-publication-on-your-website",{"title":40,"icon":10,"path":41,"stem":42,"children":43,"page":10},"Part 3: Using Cirrus Reader Studio","\u002Fusing-cirrus-reader-studio","04.using-cirrus-reader-studio",[44,48,52,56,60,64,68,72,76,80],{"title":45,"path":46,"stem":47},"6. Dashboard","\u002Fusing-cirrus-reader-studio\u002Fdashboard","04.using-cirrus-reader-studio\u002F01.dashboard",{"title":49,"path":50,"stem":51},"7. Catalogue: publications","\u002Fusing-cirrus-reader-studio\u002Fcatalogue-publications","04.using-cirrus-reader-studio\u002F02.catalogue-publications",{"title":53,"path":54,"stem":55},"8. Catalogue: collections","\u002Fusing-cirrus-reader-studio\u002Fcatalogue-collections","04.using-cirrus-reader-studio\u002F03.catalogue-collections",{"title":57,"path":58,"stem":59},"9. Reader Instances","\u002Fusing-cirrus-reader-studio\u002Freader-instances","04.using-cirrus-reader-studio\u002F04.reader-instances",{"title":61,"path":62,"stem":63},"10. Putting a Reader Instance on your website","\u002Fusing-cirrus-reader-studio\u002Fputting-a-reader-instance-on-your-website","04.using-cirrus-reader-studio\u002F05.putting-a-reader-instance-on-your-website",{"title":65,"path":66,"stem":67},"11. Domains","\u002Fusing-cirrus-reader-studio\u002Fdomains","04.using-cirrus-reader-studio\u002F06.domains",{"title":69,"path":70,"stem":71},"12. Resource Manager","\u002Fusing-cirrus-reader-studio\u002Fresource-manager","04.using-cirrus-reader-studio\u002F07.resource-manager",{"title":73,"path":74,"stem":75},"13. Reader Users","\u002Fusing-cirrus-reader-studio\u002Freader-users","04.using-cirrus-reader-studio\u002F08.reader-users",{"title":77,"path":78,"stem":79},"14. Integrations","\u002Fusing-cirrus-reader-studio\u002Fintegrations","04.using-cirrus-reader-studio\u002F09.integrations",{"title":81,"path":82,"stem":83},"15. Settings","\u002Fusing-cirrus-reader-studio\u002Fsettings","04.using-cirrus-reader-studio\u002F10.settings",{"title":85,"icon":10,"path":86,"stem":87,"children":88,"page":10},"Part 4: Reference","\u002Freference","05.reference",[89,93,97,101],{"title":90,"path":91,"stem":92},"16. Troubleshooting and common questions","\u002Freference\u002Ftroubleshooting-and-common-questions","05.reference\u002F01.troubleshooting-and-common-questions",{"title":94,"path":95,"stem":96},"17. Limits and file types at a glance","\u002Freference\u002Flimits-and-file-types-at-a-glance","05.reference\u002F02.limits-and-file-types-at-a-glance",{"title":98,"path":99,"stem":100},"18. Glossary","\u002Freference\u002Fglossary","05.reference\u002F03.glossary",{"title":102,"path":103,"stem":104},"19. Getting help","\u002Freference\u002Fgetting-help","05.reference\u002F04.getting-help",{"id":106,"title":19,"body":107,"description":588,"extension":624,"meta":625,"navigation":626,"path":20,"seo":627,"stem":21,"__hash__":629},"docs\u002F02.understanding-cirrus-reader-studio\u002F02.key-concepts.md",{"type":108,"value":109,"toc":587},"minimark",[110,119,124,129,132,136,149,152,156,163,179,186,193,197,223,230,234,238,244,248,251,283,287,302,309,313,319,333,339,351,355,362,366,373,377,392,396,400,407,410,428,432,442,446,456,460,467,471,474,481,485,496,503,507,514,518,522,533,537,548,551,555,559],[111,112,113,114,118],"p",{},"This chapter explains the ideas you need to use Cirrus Reader Studio. Each one is short. We would recommend reading  them once now. You can come back to them at any time, and every term is also listed in the ",[115,116,117],"a",{"href":99},"Glossary",".",[120,121,123],"h2",{"id":122},"your-account-and-team","Your account and team",[125,126,128],"h3",{"id":127},"account","Account",[111,130,131],{},"Your personal sign-in to Cirrus Reader Studio, tied to your email address. You can sign in with an email and password, or with your Google account.",[125,133,135],{"id":134},"workspace","Workspace",[111,137,138,139,143,144,148],{},"The shared space where all of your work lives: publications, collections, Reader Instances, domains, API keys, team members and billing. When you sign up, Cirrus Reader Studio creates a workspace for you; it appears as \"",[140,141,142],"em",{},"Your name","'s workspace ",[145,146,147],"strong",{},"(Personal)","\". You can also be invited into other people's workspaces, and switch between them.",[111,150,151],{},"Everything you see in Cirrus Reader Studio belongs to the workspace that is currently selected. If something seems to be missing, check that you are in the right workspace.",[125,153,155],{"id":154},"team-members-and-roles","Team members and roles",[111,157,158,159,162],{},"The people who have access to a workspace. Each person has one of two ",[145,160,161],{},"roles",":",[164,165,166,173],"ul",{},[167,168,169,172],"li",{},[145,170,171],{},"Admin",": can do everything members can, plus manage the subscription, view usage, rename the workspace, and invite or remove members.",[167,174,175,178],{},[145,176,177],{},"Member",": can work with publications, readers, domains and the other day-to-day features, but cannot see billing or manage the team.",[111,180,181,182,185],{},"The ",[145,183,184],{},"owner"," is the person whose workspace it is (the person who created it). The owner is always an admin, and only the owner can take admin rights away from another admin.",[111,187,188,189,118],{},"If you cannot see a setting described in this manual, you may need an admin to do it for you. See ",[115,190,192],{"href":191},"\u002Freference\u002Flimits-and-file-types-at-a-glance#_175-who-can-do-what","Who can do what",[125,194,196],{"id":195},"plan-and-trial","Plan and trial",[111,198,199,200,203,204,207,208,207,211,214,215,218,219,222],{},"Your ",[145,201,202],{},"plan"," (subscription) sets the maximum number of publications you can have and how much reading data your readers can use each month. The plans are ",[145,205,206],{},"Starter",", ",[145,209,210],{},"Growth",[145,212,213],{},"Pro"," and ",[145,216,217],{},"Enterprise",". New accounts start with a free ",[145,220,221],{},"30-day trial"," of the Starter plan.",[111,224,225,226,118],{},"If a trial ends or a payment fails, most of Cirrus Reader Studio is locked until an admin sorts out billing. See ",[115,227,229],{"href":228},"\u002Fusing-cirrus-reader-studio\u002Fsettings#_155-when-access-is-restricted","When access is restricted",[120,231,233],{"id":232},"your-content","Your content",[125,235,237],{"id":236},"catalogue","Catalogue",[111,239,240,241,243],{},"The full list of your publications. You manage it from ",[145,242,237],{}," in the menu.",[125,245,247],{"id":246},"publication","Publication",[111,249,250],{},"One item in your catalogue: a book, report, magazine issue, audiobook and so on. Cirrus Reader Studio accepts three kinds of publication files:",[164,252,253,267,272],{},[167,254,255,258,259,262,263,266],{},[145,256,257],{},"EPUB",": the standard e-book format. A ",[140,260,261],{},"reflowable"," EPUB adjusts its text to fit the screen, like a web page. A ",[140,264,265],{},"fixed-layout"," EPUB keeps every page exactly as designed, like a picture book.",[167,268,269],{},[145,270,271],{},"PDF",[167,273,274,277,278,282],{},[145,275,276],{},"Audio",": audiobooks in the W3C Audiobook format (files ending in ",[279,280,281],"code",{},".lpf",").",[125,284,286],{"id":285},"edition","Edition",[111,288,289,290,293,294,297,298,301],{},"A version of a publication. When you first upload a publication, it has one edition (",[145,291,292],{},"Version 1","). If you later have a corrected or updated file, you upload it as a ",[145,295,296],{},"new edition"," of the same publication instead of a new publication. One edition is always the ",[145,299,300],{},"current"," edition; that is the one readers see and the one the catalogue shows.",[111,303,304,305,308],{},"The title, author, description and language come from the edition's file and cannot be typed over afterwards. To change them, you upload a new edition. Because it is still the same publication, it keeps its ",[145,306,307],{},"Publication Id",", so embed codes and links that point to it keep working.",[125,310,312],{"id":311},"draft-and-live","Draft and Live",[111,314,315,316,162],{},"Every publication has a ",[145,317,318],{},"status",[164,320,321,327],{},[167,322,323,326],{},[145,324,325],{},"Draft",": hidden. Readers cannot open it through any of your readers.",[167,328,329,332],{},[145,330,331],{},"Live",": available. Readers can open it.",[111,334,335,336,338],{},"New uploads are ",[145,337,325],{}," unless you choose otherwise.",[340,341,342],"note",{},[111,343,344,347,348,350],{},[145,345,346],{},"Note:"," A publication must be ",[145,349,331],{}," before anyone can read it on your website.",[125,352,354],{"id":353},"metadata","Metadata",[111,356,357,358,361],{},"Details that describe a publication, such as its ISBN, publisher and the alternative text for its cover image (a short description of the cover for people who are unable to see it). Some details are read from the file automatically and cannot be changed (for example, the page count and file size). You can also create your own ",[145,359,360],{},"custom metadata fields"," for anything else you want to record, such as \"Series\" or \"Rights region\".",[125,363,365],{"id":364},"collection","Collection",[111,367,368,369,372],{},"A named group of publications, such as \"Spring catalogue\" or \"Children's titles\". A publication can be in several collections, or in none (shown as ",[145,370,371],{},"Uncategorized","). Collections help you organise your catalogue; they do not affect what readers see.",[125,374,376],{"id":375},"sample","Sample",[111,378,379,380,383,384,387,388,118],{},"A selection of chapters or pages from a publication that you are happy to make available as a free preview. You choose the sample separately for each publication. Samples are only shown through a ",[140,381,382],{},"sample instance"," (see below). On some screens Cirrus Reader Studio calls the sample a ",[145,385,386],{},"Publication Preview","; this is not the same thing as the ",[115,389,391],{"href":390},"#preview-publication","preview publication",[120,393,395],{"id":394},"showing-content-to-readers","Showing content to readers",[125,397,399],{"id":398},"reader-instance","Reader Instance",[111,401,402,403,406],{},"A saved configuration for a Reader Embed that is located on your website. It sets the layout, colours, fonts, logo, which features readers can use, which websites may show it and how strictly access is checked. You can have several – for example, one for your main shop and one for free samples. What readers actually see on your website is the ",[140,404,405],{},"Reader Embed"," that a Reader Instance produces. Depending on their circumstances, Cirrus Reader Studio sometimes also calls a Reader Instance \"Cirrus Reader instance\", \"Cirrus Reader Configuration\", \"Cirrus Reader widget\", \"Reader\" or \"Reading Instance\"; they all mean the same thing.",[111,408,409],{},"Readers never see Cirrus Reader Studio itself. They only see a Reader Instance's Reader Embed on your website.",[340,411,412],{},[111,413,414,416,417,420,421,214,424,427],{},[145,415,346],{}," In this manual, \"reader\" always means a ",[145,418,419],{},"person",". Some of Cirrus Reader Studio's buttons, such as ",[145,422,423],{},"Create A Reader",[145,425,426],{},"Save Reader",", use \"Reader\" to mean a Reader Instance.",[125,429,431],{"id":430},"default-instance","Default instance",[111,433,434,435,438,439,118],{},"The Reader Instance that Cirrus Reader Studio itself uses when you open a publication inside Studio (for example, with ",[145,436,437],{},"View Publication","). There is always only one, and it cannot be deleted. The menu item for this is  ",[145,440,441],{},"Use for internal reading",[125,443,445],{"id":444},"sample-instance","Sample instance",[111,447,448,449,452,453,118],{},"A Reader Instance that only shows the ",[115,450,375],{"href":451},"#sample"," of each publication, never the full text. To turn this on, choose ",[145,454,455],{},"Is Sample Instance",[125,457,459],{"id":458},"preview-publication","Preview publication",[111,461,462,463,466],{},"The specified publication that Cirrus Reader Studio uses to show you a live preview while you design a Reader Instance. You choose it in the catalogue with ",[145,464,465],{},"Use for Reading Instance Previews",". If you have not chosen one, the preview shows \"No publication loaded\".",[125,468,470],{"id":469},"embed-code","Embed code",[111,472,473],{},"A short piece of website code that Cirrus Reader Studio creates for each Reader Instance. Pasting it into a web page makes the Reader Embed appear on that page. \"Embedding\" simply means placing something from one website inside another.",[111,475,476,477,118],{},"Every time you save changes to a Reader Instance, its embed code changes too, and your web team must copy the new version. See ",[115,478,480],{"href":479},"\u002Fusing-cirrus-reader-studio\u002Fputting-a-reader-instance-on-your-website#_106-re-copy-the-code-after-every-change","Re-copy the code after every change",[125,482,484],{"id":483},"permitted-domain","Permitted domain",[111,486,487,488,491,492,495],{},"A website address, such as ",[279,489,490],{},"reader.example.com",", that is allowed to show your Reader Instances. (\"Domain\" is the main part of a website address.) If a Reader Instance has no permitted domains, ",[145,493,494],{},"any"," website could show it.",[340,497,498],{},[111,499,500,502],{},[145,501,346],{}," Listing your own domains stops other websites from copying your reader and your publications. Cirrus strongly recommends it.",[125,504,506],{"id":505},"api-key","API key",[111,508,509,510,513],{},"A secret password that lets another computer system, such as the server that runs your website or an online shop, talk to Cirrus automatically. You create API keys under ",[145,511,512],{},"Integrations",". Treat them like passwords and store and manage them likewise.",[120,515,517],{"id":516},"readers-and-usage","Readers and usage",[125,519,521],{"id":520},"reader-reader-user","Reader (Reader User)",[111,523,524,525,528,529,532],{},"A person who has opened one of your publications through a Reader Instance on your website. Cirrus Reader Studio shows you each reader's reading progress, bookmarks and highlights. Each reader is identified by a ",[145,526,527],{},"User Token"," (an anonymous code for their device and browser) and, if your website provides one, a ",[145,530,531],{},"User Id"," (your own identifier for that person, such as a customer number).",[125,534,536],{"id":535},"data-transfer-bandwidth","Data transfer (bandwidth)",[111,538,539,540,543,544,547],{},"The amount of data sent to readers when they read your publications, measured in megabytes (MB) and gigabytes (GB). Your plan includes a fixed amount for each ",[140,541,542],{},"billing period",". This is your ",[140,545,546],{},"bandwidth allowance",". Large files such as audiobooks and image-heavy PDFs use more.",[111,549,550],{},"If your readers use up the monthly allowance, they may be blocked from reading until the next billing period or until you update your plan.",[120,552,554],{"id":553},"shared-resource-files","Shared resource files",[125,556,558],{"id":557},"resource","Resource",[111,560,561,562,565,566,569,570,207,573,207,576,214,579,582,583,586],{},"Items shared across your workspace and managed in the ",[145,563,564],{},"Resource Manager",". There are two kinds: ",[140,567,568],{},"files"," you upload once and reuse in your Reader Instances (",[145,571,572],{},"fonts",[145,574,575],{},"logos",[145,577,578],{},"images",[145,580,581],{},"icons","), and the custom ",[145,584,585],{},"metadata fields"," you have created.",{"title":588,"searchDepth":589,"depth":590,"links":591},"",1,2,[592,599,608,617,621],{"id":122,"depth":590,"text":123,"children":593},[594,596,597,598],{"id":127,"depth":595,"text":128},3,{"id":134,"depth":595,"text":135},{"id":154,"depth":595,"text":155},{"id":195,"depth":595,"text":196},{"id":232,"depth":590,"text":233,"children":600},[601,602,603,604,605,606,607],{"id":236,"depth":595,"text":237},{"id":246,"depth":595,"text":247},{"id":285,"depth":595,"text":286},{"id":311,"depth":595,"text":312},{"id":353,"depth":595,"text":354},{"id":364,"depth":595,"text":365},{"id":375,"depth":595,"text":376},{"id":394,"depth":590,"text":395,"children":609},[610,611,612,613,614,615,616],{"id":398,"depth":595,"text":399},{"id":430,"depth":595,"text":431},{"id":444,"depth":595,"text":445},{"id":458,"depth":595,"text":459},{"id":469,"depth":595,"text":470},{"id":483,"depth":595,"text":484},{"id":505,"depth":595,"text":506},{"id":516,"depth":590,"text":517,"children":618},[619,620],{"id":520,"depth":595,"text":521},{"id":535,"depth":595,"text":536},{"id":553,"depth":590,"text":554,"children":622},[623],{"id":557,"depth":595,"text":558},"md",{},true,{"description":628,"title":19},"This chapter explains the ideas you need to use Cirrus Reader Studio. Each one is short. We would recommend reading them once now. You can come back to them at…","SLPNp0QoefHyNn4R-q_z_cEqBXErplWPBjwvoTqeCK8",[631,632],{"title":15,"path":16,"stem":17,"description":588,"children":-1},{"title":23,"path":24,"stem":25,"description":588,"children":-1},1792515139023]