Skip to main content
Any bucket with no Parameter Query in the bucket definition is automatically a Global Bucket. These buckets will be synced to all clients/users. For example, the following Sync Rules sync all todos and only unarchived lists to all clients/users: 
bucket_definitions:
  global_bucket:
    data:
      # Sync all todos
      - SELECT * FROM todos
      # Sync all lists except archived ones
      - SELECT * FROM lists WHERE archived = false
global_bucket is not a reserved keyword. You can give the bucket any name. If no Parameter Query is specified in the bucket definition, the bucket is automatically a global bucket.
Note: The table/collection names that your Data Queries select from in your Sync Rules must match the table names defined in your client-side schema.
As explained in the Overview & Key Concepts, PowerSync uses the possible values for parameters (found in your source database) to generate individual buckets that can be efficiently synced by clients/users depending on the specific parameters that apply to them. By contrast, with a Global Bucket, only a single bucket will be generated on the PowerSync Service that is shared between all your users/clients.