1"use strict";(globalThis.webpackChunk_busyapps_site_busymac=globalThis.webpackChunk_busyapps_site_busymac||[]).push([[4859],{73599(e,s,t){t.r(s),t.d(s,{assets:()=>c,contentTitle:()=>r,default:()=>u,frontMatter:()=>i,metadata:()=>o,toc:()=>l});const o=JSON.parse('{"id":"faqs/busycontacts-icloud-tag-group-too-large","title":"BusyContacts: iCloud rejected changes because a tag/group is too large","description":"iCloud has a maximum contact group (group vCard) size. Very large BusyContacts Tags (mapped to iCloud Groups) can exceed this limit and iCloud will reject the update.\\n","source":"@site/docs/faqs/busycontacts-icloud-tag-group-too-large.mdx","sourceDirName":"faqs","slug":"/faqs/busycontacts-icloud-tag-group-too-large","permalink":"/docs/faqs/busycontacts-icloud-tag-group-too-large","draft":false,"unlisted":false,"tags":[],"version":"current","lastUpdatedAt":1769904000000,"sidebarPosition":15140,"frontMatter":{"slug":"busycontacts-icloud-tag-group-too-large","title":"BusyContacts: iCloud rejected changes because a tag/group is too large","sidebar_label":"iCloud tag/group too large","sidebar_position":15140,"description":"iCloud has a maximum contact group (group vCard) size. Very large BusyContacts Tags (mapped to iCloud Groups) can exceed this limit and iCloud will reject the update.\\n","keywords":["busycontacts","icloud","carddav","tag","group","too large","incoming vcard size","403","sync error"],"last_update":{"date":"2026-02-01T00:00:00.000Z"},"search_applicability":["busycontacts:mac"]},"sidebar":"docs","previous":{"title":"BusyContacts: iCloud China sync issues","permalink":"/docs/faqs/busycontacts-icloud-china-sync"},"next":{"title":"BusyContacts (Setapp) on older macOS","permalink":"/docs/faqs/busycontacts-setapp-old-macos-issues"}}');var n=t(31085),a=t(71184);const i={slug:"busycontacts-icloud-tag-group-too-large",title:"BusyContacts: iCloud rejected changes because a tag/group is too large",sidebar_label:"iCloud tag/group too large",sidebar_position:15140,description:"iCloud has a maximum contact group (group vCard) size. Very large BusyContacts Tags (mapped to iCloud Groups) can exceed this limit and iCloud will reject the update.\n",keywords:["busycontacts","icloud","carddav","tag","group","too large","incoming vcard size","403","sync error"],last_update:{date:new Date("2026-02-01T00:00:00.000Z")},search_applicability:["busycontacts:mac"]},r=void 0,c={},l=[{value:"What you may see",id:"symptoms",level:2},{value:"Why this happens",id:"why",level:2},{value:"Fix: split the tag into smaller tags",id:"fix",level:2},{value:"Preventing it",id:"prevent",level:2}];function d(e){const s={a:"a",code:"code",h2:"h2",li:"li",ol:"ol",p:"p",strong:"strong",ul:"ul",...(0,a.R)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsxs)(s.p,{children:["BusyContacts can map ",(0,n.jsx)(s.strong,{children:"Tags"})," to ",(0,n.jsx)(s.strong,{children:"iCloud Groups"})," when syncing via CardDAV."]}),"\n",(0,n.jsx)(s.p,{children:"If an iCloud group becomes extremely large, iCloud may reject updates to that group."}),"\n",(0,n.jsx)(s.h2,{id:"symptoms",children:"What you may see"}),"\n",(0,n.jsxs)(s.ul,{children:["\n",(0,n.jsx)(s.li,{children:"Sync failures or conflicts when tagging many contacts in an iCloud address book."}),"\n",(0,n.jsxs)(s.li,{children:["A message similar to:","\n",(0,n.jsxs)(s.ul,{children:["\n",(0,n.jsxs)(s.li,{children:["\u201c",(0,n.jsx)(s.strong,{children:"Tag/Group too large"}),"\u201d, or"]}),"\n",(0,n.jsxs)(s.li,{children:["\u201c",(0,n.jsx)(s.strong,{children:"iCloud rejected changes because this tag is too large to update"}),"\u201d, or"]}),"\n",(0,n.jsxs)(s.li,{children:["an iCloud CardDAV error that mentions ",(0,n.jsx)(s.strong,{children:"incoming vCard size"}),"."]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,n.jsx)(s.h2,{id:"why",children:"Why this happens"}),"\n",(0,n.jsxs)(s.p,{children:["iCloud stores Groups as a special ",(0,n.jsx)(s.strong,{children:"group vCard"})," containing a list of member references.\niCloud enforces a maximum size for a contact group (Apple documents a ",(0,n.jsx)(s.strong,{children:"256 KB"})," limit for a contact group card)."]}),"\n",(0,n.jsx)(s.p,{children:"When a BusyContacts Tag is mapped to an iCloud Group, adding many members makes the group vCard grow until it exceeds iCloud\u2019s limit. At that point, iCloud rejects the update and the tag/group cannot be updated on the server."}),"\n",(0,n.jsxs)(s.p,{children:["In practice, this can happen when a single tag/group contains ",(0,n.jsx)(s.strong,{children:"tens of thousands of contacts"}),". Depending on the data involved, users often hit the limit somewhere around ",(0,n.jsx)(s.strong,{children:"~20,000\u201325,000"})," members."]}),"\n",(0,n.jsx)(s.h2,{id:"fix",children:"Fix: split the tag into smaller tags"}),"\n",(0,n.jsxs)(s.ol,{children:["\n",(0,n.jsxs)(s.li,{children:["Create one or more new Tags (for example, ",(0,n.jsx)(s.code,{children:"Customers A\u2013M"})," and ",(0,n.jsx)(s.code,{children:"Customers N\u2013Z"}),")."]}),"\n",(0,n.jsx)(s.li,{children:"Move some contacts out of the original tag and into the new tags."}),"\n",(0,n.jsx)(s.li,{children:"Let BusyContacts sync again."}),"\n"]}),"\n",(0,n.jsx)(s.p,{children:"Once each tag/group is below iCloud\u2019s group size limit, syncing should resume normally."}),"\n",(0,n.jsx)(s.h2,{id:"prevent",children:"Preventing it"}),"\n",(0,n.jsxs)(s.ul,{children:["\n",(0,n.jsx)(s.li,{children:"Avoid putting extremely large numbers of contacts into a single Tag when syncing with iCloud."}),"\n",(0,n.jsx)(s.li,{children:"If you routinely need very large \u201cgroup-like\u201d sets, consider using a more scalable sync service (Google, Fastmail, Exchange, or another CardDAV provider)."}),"\n"]}),"\n",(0,n.jsxs)(s.p,{children:["For more iCloud details, see ",(0,n.jsx)(s.a,{href:"/docs/busycontacts/77662-using-busycontacts-with-icloud",children:"Using BusyContacts with iCloud"}),"."]})]})}function u(e={}){const{wrapper:s}={...(0,a.R)(),...e.components};return s?(0,n.jsx)(s,{...e,children:(0,n.jsx)(d,{...e})}):d(e)}},71184(e,s,t){t.d(s,{R:()=>i,x:()=>r});var o=t(14041);const n={},a=o.createContext(n);function i(e){const s=o.useContext(a);return o.useMemo(function(){return"function"==typeof e?e(s):{...s,...e}},[s,e])}function r(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(n):e.components||n:i(e.components),o.createElement(a.Provider,{value:s},e.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.