---
title: "Migrate to Cloud"
canonical: "https://help.refined.com/page/migration-cloud/"
format: markdown
---
# Migrate to Cloud
> Dynamic module: Search Highlight (live content)
# Migration guides
Read our comprehensive guides comparing DC and cloud features and functionality, and how to prepare for and execute a successful migration.
### Migrate Refined for JSM to Cloud
### Migrate Refined for Confluence to Cloud
### Migrate Refined Toolkit to Cloud
# DC-to-Cloud migration advisor
Answer a few questions and we'll let you know exactly what Cloud apps you need to migrate to, based on what your current set up on DC looks like.
Refined — Cloud migration advisor @font-face{font-family:'Regola Pro';src:url(data:font/otf;base64,\_\_FONT\_BOOK\_\_) format('opentype');font-weight:400;font-style:normal;font-display:swap;} @font-face{font-family:'Regola Pro';src:url(data:font/otf;base64,\_\_FONT\_BOLD\_\_) format('opentype');font-weight:700;font-style:normal;font-display:swap;} :root{ --dark:#043E36; --bright:#4FE09B; --soft:#E8F9F0; --muted:#108465; --white:#FFFFFF; --bg:#FAFAFA; --grad:linear-gradient(135deg,#108465 0%,#043E36 100%); --radius:8px; --shadow:0 2px 12px rgba(4,62,54,.10); --font:'Regola Pro','Inter',Arial,sans-serif; } \*{box-sizing:border-box;margin:0;padding:0;} body{font-family:var(--font);font-size:16px;color:var(--dark);background:var(--bg);line-height:1.5;-webkit-font-smoothing:antialiased;} .wrap{max-width:860px;margin:0 auto;padding:0 24px;} main{padding:38px 0 70px;} .card{background:var(--white);border-radius:var(--radius);box-shadow:var(--shadow);padding:38px 40px;color:var(--dark);} @media(max-width:560px){.card{padding:26px 20px;}} .progress{display:flex;align-items:center;gap:10px;margin-bottom:26px;} .bar{flex:1;height:6px;background:var(--soft);border-radius:999px;overflow:hidden;} .bar > span{display:block;height:100%;width:0;background:var(--bright);transition:width .35s ease;} .bar-label{font-size:14px;color:var(--muted);white-space:nowrap;letter-spacing:.04em;} .ey{font-size:14px;font-weight:700;letter-spacing:.14em;text-transform:uppercase;color:var(--muted);margin-bottom:10px;} .qstep{padding-top:38px;} .qstep:first-of-type{padding-top:0;} .q{font-size:23px;font-weight:700;color:var(--dark);letter-spacing:-.01em;margin-bottom:8px;} .hint{font-size:15px;color:var(--dark);opacity:.7;margin-bottom:22px;} .hint a{color:var(--muted);font-weight:700;text-decoration:underline;} .options{display:flex;flex-direction:column;gap:12px;} .opt{display:block;width:100%;text-align:left;background:var(--white);border:1.5px solid #d9e5e1;border-radius:var(--radius);padding:16px 18px;cursor:pointer;font-family:var(--font);transition:border-color .15s,background .15s,transform .05s;} .opt:hover{border-color:var(--bright);background:var(--soft);} .opt:active{transform:translateY(1px);} .opt .ot{font-size:16px;font-weight:700;color:var(--dark);} .opt .os{font-size:14px;color:var(--dark);opacity:.7;margin-top:3px;} .nav{display:flex;align-items:center;gap:12px;margin-top:26px;} .btn{font-family:var(--font);font-size:15px;font-weight:700;border-radius:var(--radius);padding:11px 20px;cursor:pointer;border:none;} .btn.primary{background:var(--grad);color:var(--white);} .btn.sec{background:transparent;color:var(--dark);border:1.5px solid var(--dark);} .btn.ghost{background:transparent;color:var(--muted);border:none;padding:11px 6px;} .btn:disabled{opacity:.4;cursor:not-allowed;} a.btn{display:inline-block;text-decoration:none;} .result{display:none;} .result.show{display:block;animation:fade .35s ease;} @keyframes fade{from{opacity:0;transform:translateY(6px);}to{opacity:1;transform:none;}} .res-head{font-size:14px;font-weight:700;letter-spacing:.14em;text-transform:uppercase;color:var(--muted);margin-bottom:12px;} .apps{display:grid;grid-template-columns:1fr 1fr;gap:14px;margin-bottom:8px;} @media(max-width:560px){.apps{grid-template-columns:1fr;}} .appbox{border-radius:var(--radius);padding:18px;border:1.5px solid #d9e5e1;} .appbox.from{background:#FAFAFA;} .appbox.to{background:var(--soft);border-color:var(--bright);} .appbox .lbl{font-size:14px;font-weight:700;letter-spacing:.1em;text-transform:uppercase;color:var(--muted);margin-bottom:8px;} .appbox .name{font-size:18px;font-weight:700;color:var(--dark);line-height:1.25;} .appbox .env{display:inline-block;margin-top:8px;font-size:14px;color:var(--dark);opacity:.7;} .badge{display:inline-block;margin-left:8px;font-size:12px;font-weight:700;background:#fff3d6;color:#8a6d1f;border-radius:999px;padding:2px 9px;vertical-align:middle;} .alsoneed{margin:18px 0 6px;} .alsoneed .t{font-size:14px;font-weight:700;color:var(--dark);margin-bottom:8px;} .pill{display:inline-block;background:var(--soft);color:var(--dark);border:1px solid #c7eddd;border-radius:999px;padding:6px 13px;font-size:14px;font-weight:700;margin:0 6px 6px 0;} .note{background:#fff;border-left:3px solid var(--bright);border-radius:var(--radius);padding:12px 14px;font-size:14px;color:var(--dark);margin-top:16px;} .note a{color:var(--muted);font-weight:700;text-decoration:underline;} .note .cta{margin-top:12px;color:var(--white);text-decoration:none;} .reading{margin-top:40px;} .reading > .rh{font-size:23px;font-weight:700;color:var(--dark);margin-bottom:6px;letter-spacing:-.01em;} .reading > .rs{font-size:15px;color:var(--dark);opacity:.7;margin-bottom:20px;} .spacegrp{margin-bottom:22px;} .spacegrp .sg-title{display:flex;align-items:baseline;gap:8px;flex-wrap:wrap;font-size:14px;font-weight:700;letter-spacing:.06em;text-transform:uppercase;color:var(--muted);margin-bottom:10px;} .spacegrp .sg-for{font-size:14px;font-weight:400;letter-spacing:0;text-transform:none;color:var(--dark);opacity:.55;} .links{display:flex;flex-direction:column;gap:8px;} .lnk{display:flex;align-items:center;justify-content:space-between;gap:12px;text-decoration:none;background:var(--white);border:1.5px solid #d9e5e1;border-radius:var(--radius);padding:13px 16px;color:var(--dark);transition:border-color .15s,background .15s;} .lnk:hover{border-color:var(--bright);background:var(--soft);} .lnk .lt{font-size:15px;font-weight:700;} .lnk .arr{color:var(--muted);font-size:18px;flex:none;} .actions{display:flex;gap:12px;margin-top:40px;flex-wrap:wrap;}
Step 1
Step 01
Back Start over
Your migration path
You're using today
Migrate to
You'll also need these to bring your macros across:
What to read next
The migration guide for each move in your path.
Start over Change last answer
var APPS={ 'jsm-dc' :{name:'Refined for JSM DC', env:'Data Center', space:'jsm'}, 'sites-jsm' :{name:'Refined Sites for JSM', env:'Cloud', space:'jsm'}, 'conf-dc' :{name:'Refined for Confluence DC', env:'Data Center', space:'conf'}, 'sites-conf' :{name:'Refined Sites for Confluence', env:'Cloud', space:'conf'}, 'sites-isolated':{name:'Refined Sites for Isolated Cloud', env:'Cloud', space:'conf', dev:true}, 'toolkit-dc' :{name:'Refined Toolkit for Confluence DC', env:'Data Center', space:'toolkit'}, 'macro-toolkit' :{name:'Refined Macro Toolkit for Confluence', env:'Cloud', space:'toolkit'}, 'ui-toolkit' :{name:'Refined UI Toolkit for Confluence', env:'Cloud', space:'toolkit'}, 'ui-toolkit-2' :{name:'Refined UI Toolkit (Advanced Edition)', env:'Cloud', space:'toolkit', dev:true} }; var BASE='https://help.refined.com/space'; var CONTACT\_URL='https://help.refined.com/page/contact-us'; var SUPPORTED\_MACROS\_URL='https://help.refined.com/space/CLOUDDOCS/4704245196/Supported+Confluence+formatting+and+macros'; var EMBEDDED\_PAGES\_URL='https://help.refined.com/space/CLOUDDOCS/5152702506/Displaying+pages+and+blog+posts+as+in+native+Confluence'; var SPACES={ jsm:{key:'MIGRATEJSMCLOUD'}, conf:{key:'MIGRATECONFCLOUD'}, toolkit:{key:'MIGRATETOOLKITCLOUD'} }; var Q={ start:{ey:'Step 01',text:'Which Refined Data Center app are you using today?', hint:'Pick one app at a time to get the migration path, and start over for each DC app if you have more than one.',opts:\[ {ot:'Refined for JSM DC',os:'Branded sites for JSM DC', fn:function(s){s.from='jsm-dc';s.outcome='OUT-JSM';}, result:'jsm'}, {ot:'Refined Toolkit for Confluence DC',os:'Macros for Confluence DC \\u2014 Tabs, Expands and more', fn:function(s){s.from='toolkit-dc';s.outcome='OUT-TK';}, result:'toolkit'}, {ot:'Refined for Confluence DC',os:'Site builder for Confluence DC, including Content Layout and more macros', fn:function(s){s.from='conf-dc';}, go:'macros'} \]}, macros:{ey:'Step 02',text:'Are you using any macros from Refined for Confluence DC?', hint:'These macros include Activity Stream, News, and more. See the full list of macros here, and our guide on how to check if you are using these macros.',opts:\[ {ot:'Yes, we use macros from Refined for Confluence DC',os:'You\\u2019ll also need Macro Toolkit on Cloud to bring these across, with the exception of the Content Layout macro, that migrates into UI Toolkit on Cloud', fn:function(s){addOn(s,'macro-toolkit');}, go:'contentlayout'}, {ot:'No macros',os:'We only use the Refined site experience', fn:function(s){}, go:'isolated'} \]}, contentlayout:{ey:'Step 03',text:'Are you also using the Content Layout macro?', hint:'The Content Layout macro arranges content into multi-column / structured layouts.',opts:\[ {ot:'Yes, we use the Content Layout macro',os:'You\\u2019ll also need UI Toolkit on Cloud to bring these across', fn:function(s){addOn(s,'ui-toolkit');}, go:'isolated'}, {ot:'No',os:'', fn:function(s){}, go:'isolated'} \]}, isolated:{ey:'Step 04',text:'Do you need Isolated Cloud or Atlassian Government Cloud (AGC) for security or compliance?', hint:'Choose yes only if a security/compliance requirement mandates an Isolated Cloud deployment.',opts:\[ {ot:'Yes \\u2014 Isolated Cloud / Atlassian Government Cloud (AGC) required',os:'Security or compliance demands it', fn:function(s){s.to='sites-isolated';s.outcome='OUT-ISO';}, result:'isolated'}, {ot:'No',os:'Standard Refined Cloud is fine', fn:function(s){}, go:'sites'} \]}, sites:{ey:'Step 05',text:'How many Refined sites do you have on Data Center?', hint:'',opts:\[ {ot:'More than one site',os:'To keep multiple sites on Cloud you need Refined Sites for Confluence', fn:function(s){s.to='sites-conf';s.outcome='OUT-SC-MULTI';}, result:'final'}, {ot:'Just one site',os:'', fn:function(s){}, go:'usage'} \]}, usage:{ey:'Step 06',text:'Are your users mostly creating or consuming content?', hint:'',opts:\[ {ot:'Mostly consuming',os:'They read far more than they edit', fn:function(s){}, go:'thirdparty'}, {ot:'Mostly creating \\u2014 and reluctant to change too much',os:'Heavy editors who want minimal disruption', fn:function(s){s.to='ui-toolkit-2';s.outcome='OUT-UT2-CREATE';}, result:'final'} \]}, thirdparty:{ey:'Step 07',text:'Are you heavily reliant on third-party apps that render content or macros in Confluence and aren\\u2019t supported on Refined Sites?', hint:'Refined Sites for Confluence Cloud has limited third-party macro support, due to the technical effort of adding and maintaining it. See the supported Confluence formatting and macros.',opts:\[ {ot:'No \\u2014 or we\\u2019re willing to remove them to keep Refined',os:'', fn:function(s){s.to='sites-conf';s.outcome='OUT-SC-NO3P';}, result:'final'}, {ot:'Yes, we depend on them',os:'', fn:function(s){}, go:'internal'} \]}, internal:{ey:'Step 08',text:'Is your site internal-facing (private permissions), and are you OK without a custom domain on your Cloud Refined site(s)?', hint:'',opts:\[ {ot:'Yes \\u2014 internal, custom domain not needed',os:'Use embedded pages on Refined Sites for Confluence', fn:function(s){s.to='sites-conf';s.outcome='OUT-SC-INT';}, result:'final'}, {ot:'No \\u2014 it\\u2019s a public site',os:'', fn:function(s){s.to='ui-toolkit-2';s.outcome='OUT-UT2-PUB';}, result:'final'} \]} }; var TOTAL=8; function addOn(s,id){ if(s.addons.indexOf(id)<0) s.addons.push(id); } var state, navStack; function freshState(){return {from:null,to:null,addons:\[\],outcome:null};} function start(){ state=freshState(); navStack=\[\]; show('start',1); } function restart(){ start(); document.getElementById('result').classList.remove('show'); document.getElementById('quiz').style.display=''; } function show(key,depth){ var q=Q\[key\]; navStack.push({key:key, depth:depth, snapshot:JSON.parse(JSON.stringify(state))}); renderQuestion(q,depth); } function renderQuestion(q,depth){ document.getElementById('q-ey').textContent=q.ey; document.getElementById('q-text').textContent=q.text; var h=document.getElementById('q-hint'); h.innerHTML=q.hint||''; h.style.display=q.hint?'':'none'; var box=document.getElementById('q-options'); box.innerHTML=''; q.opts.forEach(function(o){ var b=document.createElement('button'); b.className='opt'; b.innerHTML=''+o.ot+'
'+(o.os?''+o.os+'
':''); b.onclick=function(){ choose(o,depth); }; box.appendChild(b); }); document.getElementById('backbtn').disabled = navStack.length<=1; var pct=Math.min(100, Math.round((depth-1)/(TOTAL-1)\*100)); document.getElementById('barfill').style.width=pct+'%'; document.getElementById('barlabel').textContent='Step '+depth; } function choose(o,depth){ if(o.fn) o.fn(state); if(o.result){ finish(o.result); } else if(o.go){ show(o.go, depth+1); } } function goBack(){ var res=document.getElementById('result'); if(res.classList.contains('show')){ // From the result, the last question answered is still on top of the stack // (finishing doesn't push a step). Re-show that question so the person can // change just that answer \\u2014 don't step back an extra question. res.classList.remove('show'); document.getElementById('quiz').style.display=''; var cur=navStack.pop(); state=JSON.parse(JSON.stringify(cur.snapshot)); show(cur.key, cur.depth); return; } if(navStack.length<=1) return; navStack.pop(); // drop the question currently shown var prev=navStack.pop(); // drop the previous one (show() re-pushes it) state=JSON.parse(JSON.stringify(prev.snapshot)); show(prev.key, prev.depth); } function contactBtn(){ return 'Contact us to learn more'; } function finish(kind){ document.getElementById('quiz').style.display='none'; var fromId=state.from, from=APPS\[fromId\]; document.getElementById('fromName').textContent=from.name; document.getElementById('fromEnv').textContent=from.env; var toId = kind==='jsm' ? 'sites-jsm' : kind==='toolkit' ? 'macro-toolkit' : state.to; var to=APPS\[toId\]; document.getElementById('toName').innerHTML=to.name + (to.dev?'In development':''); document.getElementById('toEnv').textContent=to.env; // Apps the user also needs. UI Toolkit (Advanced Edition) IS the advanced UI Toolkit, // so when migrating to ui-toolkit-2 don't double-list the standard UI Toolkit. var addons=state.addons.filter(function(id){return id!==toId;}); if(toId==='ui-toolkit-2'){ addons=addons.filter(function(id){return id!=='ui-toolkit';}); } var also=document.getElementById('alsoneed'); var pills=document.getElementById('alsoPills'); pills.innerHTML=''; if(addons.length){ also.style.display=''; addons.forEach(function(id){ var a=APPS\[id\]; var span=document.createElement('span'); span.className='pill'; span.innerHTML=a.name+(a.dev?' In development':''); pills.appendChild(span); }); } else { also.style.display='none'; } // In-dev / isolated note, with a primary "Contact us" button left-aligned inside the box. var note=document.getElementById('resNote'); if(kind==='isolated'){ note.style.display=''; note.innerHTML='Needing an Isolated Cloud or Atlassian Government Cloud (AGC) deployment decides the product for you. Refined Sites for Isolated Cloud and an AGC option are currently in development \\u2014 please reach out to the Refined team for more information and timelines.
'+contactBtn(); } else if(to.dev){ note.style.display=''; note.innerHTML=''+to.name+' is currently in development. It\\u2019s the recommended fit for this path \\u2014 check with the Refined team on availability before you plan the move.
'+contactBtn(); } else { note.style.display='none'; note.innerHTML=''; } renderInfoNotes(); // Reading. For Isolated Cloud we drop the Isolated Cloud guide and keep only the // Macro Toolkit / UI Toolkit guides; everything else reads guides for the full path. var readingTargets = (kind==='isolated') ? addons.slice() : \[toId\].concat(addons); var extraLinks=\[\]; if(state.outcome==='OUT-SC-MULTI'){ extraLinks.push({text:'Read about supported Confluence macros and formatting on Refined Sites for Confluence Cloud', href:SUPPORTED\_MACROS\_URL}); } renderReading(readingTargets, from.name, extraLinks); document.getElementById('result').classList.add('show'); } function renderInfoNotes(){ var host=document.getElementById('infoNotes'); host.innerHTML=''; var notes=\[\]; if(state.outcome==='OUT-UT2-CREATE'){ notes.push('Another option is to migrate to Refined Sites for Confluence Cloud using embedded pages \\u2014 though this comes with some limitations. Read the docs to learn more \\u2192'); } if(state.outcome==='OUT-SC-INT'){ notes.push('To show your third-party macros you\\u2019ll need to use embedded pages, which comes with some limitations. Read the docs to learn more \\u2192'); } if(state.addons.indexOf('macro-toolkit')>=0){ notes.push('Your macros from Refined for Confluence DC are migrated into Refined Macro Toolkit for Confluence Cloud. All migrated macros are fully rendered on Confluence pages viewed through Refined Sites for Confluence Cloud.'); } if(state.addons.indexOf('ui-toolkit')>=0){ notes.push('Your Content Layout macros from Refined for Confluence DC are migrated into Refined UI Toolkit for Confluence Cloud. All migrated macros are fully rendered on Confluence pages viewed through Refined Sites for Confluence Cloud.'); } notes.forEach(function(html){ var d=document.createElement('div'); d.className='note'; d.innerHTML=html; host.appendChild(d); }); } function renderReading(resultApps, fromName, extraLinks){ var order=\['conf','jsm','toolkit'\], byspace={}; resultApps.forEach(function(id){ var sp=APPS\[id\]&&APPS\[id\].space; if(!sp) return; (byspace\[sp\]=byspace\[sp\]||\[\]).push(APPS\[id\].name); }); var host=document.getElementById('readingGroups'); host.innerHTML=''; var list=document.createElement('div'); list.className='links'; order.filter(function(sp){return byspace\[sp\];}).forEach(function(sp){ var n=byspace\[sp\]; var toText = n.length>1 ? n.slice(0,-1).join(', ')+' and '+n\[n.length-1\] : n\[0\]; var a=document.createElement('a'); a.className='lnk'; a.href=BASE+'/'+SPACES\[sp\].key; a.target='\_blank'; a.rel='noopener'; a.innerHTML='Read the migration guide to '+toText+'\\u2192'; list.appendChild(a); }); (extraLinks||\[\]).forEach(function(l){ var a=document.createElement('a'); a.className='lnk'; a.href=l.href; a.target='\_blank'; a.rel='noopener'; a.innerHTML=''+l.text+'\\u2192'; list.appendChild(a); }); host.appendChild(list); var sec=document.getElementById('readingSection'); if(sec){ sec.style.display = list.children.length ? '' : 'none'; } } start();
## Children
- [Migrate Refined for JSM to Cloud](https://help.refined.com/space/MIGRATEJSMCLOUD.md)
- [Migrate Refined for Confluence to Cloud](https://help.refined.com/space/MIGRATECONFCLOUD.md)
- [Migrate Refined Toolkit to Cloud](https://help.refined.com/space/MIGRATETOOLKITCLOUD.md)