• Stitch >
• MongoDB Atlas >
• Configure MongoDB

Configure Advanced Rules

Overview

You can manually configure all aspects of a collection’s rules by editing the underlying configuration document directly through the Stitch UI. Editing rules in this way is referred to as Advanced Mode.

When To Use Advanced Mode

The default or “Basic Mode” rules editor in the Stitch UI covers the majority of use cases for collection rules. However, there are times when you need more fine-grained control than the UI interface provides. Consider using Advanced Mode if you need to do the following:

• Configure a role that can only insert documents.
• Define field-level read or write permissions for a field in an embedded document.
• Determine field-level write permissions dynamically using a JSON expression.

Warning

Once you convert a collection’s rules to Advanced Mode, you may not be able to switch back to editing that collection’s rules through the Basic Mode interface.

Procedure

1

Navigate to the Collection Rules Screen

You can edit collection rules in Advanced Mode from the MongoDB rules screen in the Stitch UI. To get to the rules screen for a collection, click Rules beneath MongoDB Clusters in the left-hand navigation and then select the collection from the list.

2

Convert to Advanced Mode

Click Advanced Mode in the top right corner of the collection rules interface. The UI will switch an editor that shows a preview of the underlying Advanced Mode rule configuration document. Click Convert to Advanced Mode and then click Convert Rules to confirm.

3

Define the Collection Rules

Once you have converted the collection to Advanced Mode you can edit the underlying configuration document. Collection rule configuration documents have the following form:

copy

{
  "roles": [
    <Role Configuration>,
    ...
  ],
  "filters": [
    <Filter Configuration>,
    ...
  ],
  "schema": {
    "properties": {
      "<Field Name>": <Schema Document>,
      ...
    }
  }
}

Field	Description
roles	An array of Query Role configuration documents that each define a single role’s Apply When condition and associated CRUD permissions. Important Stitch evaluates roles for each query in the order that they’re defined. Ensure that each role configuration document’s array index matches its desired position in the evaluation order.
filters	An array of Query Filter configuration documents that each define a filter on the collection.
schema	A Document Schema that configures the shape and contents of all documents in the collection. Note The root of all collection schemas must be an object schema document. You can embed other schema types inside the properties field of the root schema.

4

Save the Updated Collection Rules

Once you have finished editing the collection rules, click Save. Stitch will immediately begin using the new rule configuration you defined for all incoming queries on the collection.

←   Enforce a Document Schema Specify Read Preference for a MongoDB Cluster  →

© MongoDB, Inc 2008-present. MongoDB, Mongo, and the leaf logo are registered trademarks of MongoDB, Inc.