Wix Pricing Plans Collections

This article explains the fixed permissions and field structure for the Wix Pricing Plans Plans collection.

Note: This collection is a system collection, so you can't change its permissions in the CMS.

Tip: Before continuing, make sure you've read Working with Wix App Collections.

Plans

This section explains the permissions and fields available in the Plans collection.

To use the Plans collection in code, refer to it as PaidPlans/Plans.

Permissions

The Plans collection has the following permissions:

  • read: ANYONE
  • create: None
  • update: None
  • remove: None

Fields

This section describes each field in this collection and its properties.

Note: This app collection contains read-only fields that cannot be managed from the collection. You can update the fields from the relevant app in your site's dashboard.

The fields are listed in the same order as the collection's default order in the CMS.

_id

Description: The unique pricing plan ID that was created by the server. This is a system field and is hidden by default.

Type: Text

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: No

Filter Support: eq, ne, hasSome, contains

Read-only: Yes

roleId

Description: The role ID to assign to the buyer of the plan after purchase.

Type: Text

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: No

Filter Support: No

Read-only: Yes

name

Description: The name of the pricing plan.

Type: Text

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: No

Filter Support: No

Read-only: Yes

tagline

Description: The tagline for the pricing plan.

Type: Text

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: No

Filter Support: No

Read-only: Yes

ribbon

Description: The ribbon available for this pricing plan. The ribbon lets you show additional information about the plan, such as "New!".

Type: Text

Can connect to data: No

Can use in dynamic page URL: No

Sortable: No

Filter Support: No

Read-only: Yes

benefits

Description: Lists the benefits included in the plan as an array of strings.

Type: Tags

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: No

Filter Support: No

Read-only: Yes

price

Description: The price of the plan.

Type: Number

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: No

Filter Support: No

Read-only: Yes

currency

Description: The plan's currency. Because plans have only one currency, this value is the same for all plans.

Type: Text

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: No

Filter Support: No

Read-only: Yes

recurring

Description: Indicates whether the plan's payments are recurring (true) or one time only (false).

Type: Boolean

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: No

Filter Support: No

Read-only: Yes

validUntilCanceled

Description: Indicates whether the plan is valid until the user explicitly cancels the payments (true).

Type: Boolean

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: No

Filter Support: No

Read-only: Yes

periodUnit

Description: The payment recurrence for the plan. Valid values are WEEK, MONTH, and YEAR.

Type: Text

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: No

Filter Support: No

Read-only: Yes

periodAmount

Description: The plan is valid for this number of weeks, months, or years.

Type: Number

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: No

Filter Support: No

Read-only: Yes

primary

Description: Indicates if the plan is the primary plan. When viewing pricing plans on the site, the primary plan is highlighted with a customizable ribbon.

Type: Boolean

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: Yes

Filter Support: eq, ne

Read-only: Yes

dateCreated

Description: Displays the date and time the plan was created.

Type: Date and Time

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: Yes

Filter Support: eq, ne, le, ge, lt, gt

Read-only: Yes

dateUpdated

Description: Displays the date and time the plan was last modified.

Type: Date and Time

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: Yes

Filter Support: eq, ne, le, ge, lt, gt

Read-only: Yes

displayIndex

Description: The index of the plan in the order it is displayed in Manage Plans from the site's dashboard. The index of the left-most plan on the top row has the value 1, the next one has the value 2, and so on. As time passes, if plans are deleted, the indexes of the remaining plans are not renumbered. They continue to be displayed in Manage Plans in the same numeric order.

Type: Number

Can connect to data: Yes

Can use in dynamic page URL: No

Sortable: Yes

Filter Support: eq, ne, le, ge, lt, gt

Read-only: Yes

slug

Description: The plan's slug, which is its URL-friendly name that is unique across the site.

Type: Text

Can connect to data: Yes

Can use in dynamic page URL: Yes

Sortable: No

Filter Support: Yes

Read-only: Yes

Did this help?