> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt # Resource: Marketing Settings V1 # Type: Marketing Settings Object # Link: https://dev.wix.com/docs/api-reference/business-management/marketing/marketing-plan/marketing-settings-v1/marketing-settings-object.md ## Description: A site's marketing preferences that shape how the AI generates its marketing plan and posts. Settings are optional: if a site hasn't configured them, sensible defaults are applied automatically when a plan is generated. Owners can customize any combination of fields using the UpsertMarketingSettings method. Settings are shared across all enabled marketing tools unless a tool-specific override is set in `overrides`. ## Schema: ```json Type: Marketing Settings Object | type: MarketingSettings Description: A site's marketing preferences that shape how the AI generates its marketing plan and posts. Settings are optional: if a site hasn't configured them, sensible defaults are applied automatically when a plan is generated. Owners can customize any combination of fields using the UpsertMarketingSettings method. Settings are shared across all enabled marketing tools unless a tool-specific override is set in `overrides`. - name: id | type: string | description: Unique ID of the marketing settings, equal to the site's MetaSite ID. - name: value | type: string | description: - name: settings | type: Settings | description: Core preferences that apply to all marketing tools unless a tool-specific override is set. - name: toneOfVoice | type: string | description: Writing style description used to shape the voice of generated post captions. - name: pointOfView | type: string | description: Narrative perspective used in generated post captions (first, second, or third person). enum: FIRST_PERSON, SECOND_PERSON, THIRD_PERSON - name: customContentGuidelines | type: string | description: Free-text instructions that further personalize how content is written, beyond `tone_of_voice`. - name: language | type: Language | description: Language and regional variation used for generated content. Read-only; derived from site properties. - name: language | type: string | description: Language for generated content (e.g., `English`, `Spanish`). - name: regionalVariation | type: string | description: Regional variation of the language (e.g., `Australian` when `language` is `English`). - name: topics | type: Topics | description: Content pillars: topics the AI should focus on or avoid when generating posts. - name: included | type: Array | description: Topics the AI should actively incorporate into generated content. - name: excluded | type: Array | description: Topics the AI should avoid in generated content. - name: coreTopic | type: string | description: The primary theme that anchors all generated content. Stored but not currently used during generation; the fields that influence generation are `topics.included` and `topics.excluded`. - name: imageGuidelines | type: string | description: Free-text style instructions applied when generating images for posts. - name: marketingPlanGoal | type: MarketingPlanGoal | description: Overall goal of the marketing plan, used to align content strategy across all tools. - name: socialChannels | type: Array | description: Social platforms to generate content for. Social post drafts are only produced when `SOCIAL_MARKETING` is included in `marketing_tools`. enum: FACEBOOK, INSTAGRAM, LINKEDIN, TWITTER, PINTEREST, GBP, TIKTOK - name: frequency | type: Frequency | description: Posting cadence that acts as a fallback for social marketing only. Per-tool cadences are controlled by `overrides.socialMarketing.frequency`, `overrides.blogs.frequency`, and `overrides.emailMarketing.frequency` (each with its own per-tool default). - name: interval | type: string | description: Time unit for the posting cadence (`WEEK`, `MONTH`, or `YEAR`). - name: count | type: number | description: Number of posts to produce within each `interval`. - name: marketingTools | type: Array | description: Marketing tools enabled in the plan. Social post drafts are only generated when `SOCIAL_MARKETING` is present. enum: EMAIL_MARKETING, BLOGS, SOCIAL_MARKETING - name: businessProfile | type: BusinessProfile | description: Business context (goal, value proposition, and target audience) used to tailor content. - name: businessGoal | type: string | description: What the business is trying to achieve (e.g., grow revenue, build community). - name: valueProposition | type: string | description: What makes the business unique and why customers should choose it. - name: targetAudience | type: string | description: Description of the intended audience the business wants to reach. - name: calendar | type: Calendar | description: Calendars whose events the AI considers when planning marketing activities. - name: ids | type: Array | description: IDs of the selected calendar options. - name: targetLocations | type: Array | description: Deprecated. Read-only; derived from the site. Use `business_location` instead. - name: businessLocation | type: BusinessLocation | description: Business location used to generate location-specific content. Read-only; derived from SEO settings. - name: id | type: string | description: Unique identifier for the business location (msid) - name: physicalLocations | type: Array | description: List of physical business locations (maximum 5) - name: serviceLocations | type: Array | description: List of service areas where the business operates (maximum 5) - name: online | type: boolean | description: Indicates whether the business operates online - name: createdDate | type: string | description: Timestamp when the business location was created (ISO 8601 format) - name: updatedDate | type: string | description: Timestamp when the business location was last updated (ISO 8601 format) - name: imageGenerationSettings | type: ImageGenerationSettings | description: Controls how images are generated for posts (mode and photo sources). These values are stored but aren't currently applied during generation. - name: mode | type: string | description: How images are generated for posts. - name: enabledPhotoSources | type: Array | description: Photo sources the AI may draw from when generating or remixing images. - name: overrides | type: SettingsOverrides | description: Per-tool overrides. Unset fields in an override inherit the value from `settings`. - name: emailMarketing | type: Settings | description: Settings applied only when generating email marketing content, overriding the shared settings. - name: blogs | type: Settings | description: Settings applied only when generating blog content, overriding the shared settings. - name: socialMarketing | type: Settings | description: Settings applied only when generating social marketing content, overriding the shared settings. - name: createdAt | type: string | description: Date and time the marketing settings were created. - name: seconds | type: string | description: - name: nanos | type: number | description: - name: updatedAt | type: string | description: Date and time the marketing settings were last updated. ```